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This volume gives descriptions of the publicly available 
features of the UNIX+ and, therefore, the ULTRIX-11 system. 
It does not attempt to provide perspective or tutorial 
information upon the UNIX or the ULTRIX-11 operating system, 
its facilities, or its implementation. Various documents on 
those topics are contained in Volume 2, the ULTRIX-11 
software Technical Description, the ULTRIX-11 Installation 
Guide, and the ULTRIX-11 System Management Guide. In par- 
ticular, for an overview see 'The UNIX Time-Sharing System' 
by Ritchie and Thompson; for a tutorial see 'UNIX for 
Beginners' by Kernighan. 

Within the area it surveys, this volume attempts to be 
timely, complete and concise. Where the latter two objec- 
tives conflict, the obvious is often left unsaid in favor of 
brevity. It is intended that each program be described as 
it is, not as it should be. Inevitably, this means that 
various sections will soon be out of date. 

The volume is divided into eight sections: 

1 . Commands 

2. System calls 

3. Subroutines 

4. Special files 

5. File formats and conventions 

6. Games 

7. Macro packages and language conventions 

8. Maintenance 

Commands are programs intended to be invoked directly by the 
user, in contradistinction to subroutines, which are 
intended to be called by the user's programs. Commands gen- 
erally reside in directory /bin (for bin ary programs). Some 
programs also reside in /usr/bin, to save space in /bin. 
These directories are searched automatically by the command 
interpreter. 

System calls are entries into the ULTRIX-11 supervisor. 
Every system call has one or more C language interfaces 
described in section 2. The underlying assembly language 
interface, coded with opcode sys , a synonym for trap , is 
given as well. 
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An assortment of subroutines is available; they are 
described in section 3. The primary libraries in which they 
are kept are described in intro Q). The functions are 
described in terms of C, but most will work with Fortran as 
well. 

The special files section 4 discusses the characteristics of 
each system 'file' that actually refers to an I/O device 
The names in this section refer to the DEC device names for 
the hardware, instead of the names of the special files 
themselves. 

The file formats and conventions section 5 documents the 
structure of particular kinds of files; for example, the 
form of the output of the loader and assembler is given. 
Excluded are files used by only one command, for example the 
assembler's intermediate files. 

Games have been relegated to section 6 to keep them from 
contaminating the more staid information of section 1. 

Section 7 is a miscellaneous collection of information 
necessary to writing in various specialized languages: char- 
acter codes, macro packages for typesetting, etc. 

The maintenance section 8 discusses procedures not intended 
for use by the ordinary user. These procedures often 
involve use of commands of section 1, where an attempt has 
been made to single out peculiarly maintenance-flavored com- 
mands by marking them IM. Much of section 8 has been super- 
seded by the ULTRIX-11 System Management Guide. 

Each section consists of a number of independent entries of 
a page or so each. The name of the entry is in the upper 
corners of its pages, together with the section number, and 
sometimes a letter characteristic of a subcategory e g 
graphics is IG, and the math library is 3M. Entries within 
each section are alphabetized. The page numbers of each 
entry start at 1; it is infeasible to number consecutively 
the pages of a document like this that is republished in 
many variant forms. 



- 3 - 



All entries are based on a common format, not all of whose 
subsections will always appear. 

The name subsection lists the exact names of the com- 
mands and subroutines covered under the entry and gives 
a very short description of their purpose. 

The synopsis summarizes the use of the program being 
described. A few conventions are used, particularly in 
the Commands subsection: 



Square brackets [ ] around an argument indicate 

that the argument is optional. When an argvmient 

is given as 'name', it always refers to a file 
name. 

Ellipses '...' are used to show that the previous 
argument-prototype may be repeated. 

A final convention is used by the commands them- 
selves. An argument beginning with a minus sign 
'-' is often taken to mean some sort of option- 
specifying argument even if it appears in a posi- 
tion where a file name could appear. Therefore, 
it is unwise to have files whose names begin with 



The description subsection discusses in detail the sub- 
ject at hand. 

The files subsection gives the names of files which are 
built into the program. 

A see also subsection gives pointers to related infor- 
mation. 

A diagnostics subsection discusses the diagnostic indi- 
cations which may be produced. Messages which are 
intended to be self-explanatory are not listed. 

The bugs subsection gives known bugs and sometimes 
deficiencies. Occasionally also the suggested fix is 
described. 

In section 2 an assembler subsection carries the assem- 
bly language system interface. 
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At the beginning of the volume is a table of contents 
organized by section and alphabetically within each section! 
There is also a permuted index derived from the table of 
contents. Within each index entry, the title of the writeup 
to which It refers is followed by the appropriate section 
number m parentheses. This fact is important because there 
IS considerable name duplication among the sections, arising 
principally from commands which exist only to exercise a 
particular system call. 

HOW TO GET STARTED 

This section sketches the basic information you need to get 
started on ULTRIX-11: how to log in and log out, how to com- 
municate through your terminal, and how to run a program 
See 'UNIX for Beginners' in Volume 2 for a more complete 
introduction to the system. 

Logging Ln. You must call, or directly access, ULTRIX-11 
from an appropriate terminal. Most hardcopy and video ter- 
minals, preferably with upper and lower case, are supported 
You must also have a valid user name, which may be obtained* 
together with the telephone number, from the system adminis- 
trators. The same telephone number serves terminals operat- 
ing at all the standard speeds. After a data connection is 
established, the login procedure depends on what kind of 
terminal you are using. 

300- baud terminals : These terminals generally have a speed 
switch which should be set at '300' (or '30' for 30 charac- 
ters per second) and a half/full duplex switch which should 
be set at full-duplex. (This switch will often have to be 
changed since many other systems require half-duplex). When 
a connection is established, the system types 'login:'- you 
type your user name, followed by the 'return' key. if you 
have a password, the system asks for it and turns off the 
printer on the terminal so the password will not appear 
After you have logged in, the 'return', 'new line' or 
linefeed' keys will give exactly the same results. 

1200- and 150- baud terminals : If there is a half/full 
duplex switch, set it at full-duplex. When you have esta- 
blished a data connection, the system types out a few gar- 
bage characters (the 'login:' message at the wrong speed) 
Depress the 'break' (or 'interrupt') key; this is a speed- 
independent signal to ULTRIX-11/ that a different speed ter- 
minal is in use. The system then will type 'login:,' this 
time at another speed. Continue depressing the break key 
until 'login:' appears in clear, then respond with your user 
name. Terminate each line you type with the 'return' key. 

Hard - wired terminals . Hard-wired terminals usually begin 
at the right speed, up to 9600 baud; otherwise the precedina 
instructions apply. 
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For all these terminals, it is important that you type your 
name in lower-case if possible; if you type upper-case 
letters, ULTRIX-11 will assume that your terminal cannot 
generate lower-case letters and will translate all subse- 
quent upper-case letters to lower case. 

The evidence that you have successfully logged in is that 
the Shell program will type a '$' to you. (The Shell is 
described below under 'How to run a program.') 

For more information, consult stty (l) , which tells how to 
adjust terminal behavior, getty (8) , which discusses the 
login sequence in more detail, and tty (4) , which discusses 
terminal I/O. 

Logging out . There are three ways to log out: 

You can simply hang up the phone. 

You can log out by typing an end-of-file indication 
(EOT character, control-d) to the Shell. The Shell 
will terminate and the 'login: ' message will appear 
again. 

You can also log in directly as another user by giving 
a login (l) command. 

How to communicate through your terminal. When you type 
characters, a gnome deep in the system gathers your charac- 
ters and saves them in a secret place. The characters will 
not be given to a program until you type a return (or new- 
line), as described above in Logging in. 

ULTRIX-11 terminal I/O is full-duplex. It has full read- 
ahead, which means that you can type at any time, even while 
a program is typing at you. Of course, if you type during 
output, the printed output will have the input characters 
interspersed. However, whatever you type will be saved up 
and interpreted in correct sequence. There is a limit to 
the amount of read-ahead, but it is generous and not likely 
to be exceeded unless the system is in trouble. When the 
read-ahead limit is exceeded, the system throws away all the 
saved characters. 
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The character 'control-u' in typed input kills all the 
preceding characters in the line, so typing mistakes can be 
repaired on a single line. Also, the character 'delete' 
erases the last character typed. Successive uses of 
'delete' erase characters back to, but not beyond, the 
beginning of the line. The 'control-u' and 'delete' can be 
transmitted to a program by preceding them with '\'. (So, 
to erase '\', you need two ' delete 's). These conventions 
can be changed by the stty (l) command. 

Typing 'control-c' causes an interrupt signal, which is not 
passed to programs. This signal generally causes whatever 
program you are running to terminate. It is typically used 
to stop a long printout that you don't want. However, pro- 
grams can arrange either to ignore this signal altogether, 
or to be notified when it happens (instead of being ter- 
minated). The editor, for example, catches interrupts and 
stops what it is doing, instead of terminating, so that an 
interrupt can be used to halt an editor printout without 
losing the file being edited. 

The quit signal is generated by typing the ASCII FS charac- 
ter. (FS appears many places on different terminals, most 
commonly as control-\.) It not only causes a running program 
to terminate but also generates a file with the core image 
of the terminated process. Quit is useful for debugging. 

Besides adapting to the speed of the terminal, ULTRIX-11 
tries to be_ intelligent about whether you have a terminal 
with the newline function or whether it must be simulated 
with carriage-return and line-feed. In the latter case, all 
input carriage returns are turned to newline characters (the 
standard line delimiter) and both a carriage return and a 
line feed are echoed to the terminal. If you get into the 
wrong mode, the stty (l) command will rescue you. 

Tab characters are used freely in ULTRIX-11 source programs. 
If your terminal does not have the tab function, you can 
arrange to have them turned into spaces during output, and 
echoed as spaces during input. The system assumes that tabs 
are set every eight columns. Again, the stty(l) command 
will set or reset this mode. Also, the command tabs (l) will 
set the tab stops automatically on many terminals. 
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How to run a program ; the Shell . When you have success- 
fully logged in, a program called the Shell is listening to 
your terminal. The Shell reads typed-in lines, splits them 
up into a command name and arguments, and executes the com- 
mand. A command is simply an executable program. The Shell 
looks first in your current directory (see below) for a pro- 
gram with the given name, and if none is there, then in a 
system directory. There is nothing special about system- 
provided commands except that they are kept in a directory 
where the Shell can find them. 

The command name is always the first word on an input line; 
it and its arguments are separated from one another by 
spaces. 

When a program terminates, the Shell will ordinarily regain 
control and type a '$' at you to indicate that it is ready 
for another command. 

The Shell has many other capabilities, which are described 
in detail in section sh(l). 

The current directory . ULTRIX-11 has a file system 
arranged in a hierarchy of directories. When the system 
administrator gave you a user name, he also created a direc- 
tory for you (ordinarily with the same name as your user 
name). When you log in, any file name you type is by 
default in this directory. Since you are the owner of this 
directory, you have full permission to read, write, alter, 
or destroy its contents. Permissions to have your will with 
other directories and files will have been granted or denied 
to you by their owners. As a matter of observed fact, few 
ULTRIX-11 users protect their files from destruction, let 
alone perusal, by other users. 

To change the current directory (but not the set of permis- 
sions you were endowed with at login) use cd(l). 
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Path names . To refer to files not in the current direc- 
tory, you must use a path name. Full path names begin with 
'/', the name of the root directory of the whole file sys- 
tem. After the slash comes the name of each directory con- 
taining the next sub-directory (followed by a '/') until 
finally the file name is reached. For example, 
/usr/ lem / filex refers to the file f ilex in the directory 
lem; lem is itself a subdirectory of usr; usr springs 
directly from the root directory. 

If your current directory has subdirectories, the path names 
of files therein begin with the name of the subdirectory 
with no prefixed '/'. 

A path name may be used anywhere a file name is required. 

Important commands which modify the contents of files are 
cg(l), mvd), and rm(l), which respectively copy, move (i.e. 
rename) and remove files. To find out the status of files 
or directories, use ls(l). See mkdir (l) for making direc- 
tories and rmdir (in rSTl)) for destroying them. 

For a fuller discussion of the file system, see 'The UNIX 
Time-Sharing System,' by Ken Thompson and Dennis Ritchie and 
Chapter 1 of the 'ULTRIX-11 System Management Guide'. It 
may also be useful to glance through section 2 of this 
manual, which discusses system calls, even if you don't 
intend to deal with the system at that level. 

Writing a program . To enter the text of a source program 
into a ULTRIX-11 file, use the editor ed(l). The three 
principal languages in ULTRIX-11 are provided by the C com- 
piler cc(l), the Fortran compiler f77(l), and the assembler 
as(l). After the program text has been entered through the 
editor and written on a file, you can give the file to the 
appropriate language processor as an argument. The output 
of the language processor will be left on a file in the 
current directory named 'a. out'. (If the output is pre- 
cious, use mv to move it to a less exposed name soon.) If 
you wrote in assembly language, you will probably need to 
load the program with library subroutines; see ld(l). The 
other two language processors call the loader automatically. 

When you have finally gone through this entire process 

without provoking any diagnostics, the resulting program can 

be run by giving its name to the Shell in response to the 
' $ ' prompt . 

Your programs can receive arguments from the command line 
just as system programs do, see exec(2). 
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Text processing . Almost all text is entered through the 
editor ed(l) . "^The commands most often used to write text on 
a terminal are: cat , pr , rof f and nrof f , all in section 1. 

The cat command simply dumps ASCII text on the terminal, 
with no processing at all. The £r command paginates the 
text, supplies headings, and has a facility for multi-colximn 
output. Nrof f is an elaborate text formatting program. 
Used naked^ it requires careful forethought, but for ordi- 
nary documents it has been tamed; see ms{7). Rof f is a 
simpler text formatting program, and requires somewhat less 
forethought. 

Trof f prepares documents for a Graphics Systems photo- 
typesetter; it is very similar to nrof f , and often works 
from exactly the same source text. It was used to produce 
this manual. 

Status inquiries . Various commands exist to provide you 
with useful information. Who ( 1 ) prints a list of users 
presently logged in. Date (l) prints the current time and 
date. Ls(l) will list the files in your directory or give 
summary information about particular files. 

Surprises . Certain commands provide inter-user communica- 
tion. Even if you do not plan to use them, it would be well 
to learn something about them, because someone else may aim 
them at you. 

To communicate with another user currently logged in, 
write (l) is used; mail (l) will leave a message whose pres- 
ence will be announced to another user when he next logs in. 
The write-ups in the manual also suggest how to respond to 
the two commands if you are a target. 

When you log in, a message-of-the-day may greet you before 
the first '$' . 

CONVERTING FROM THE 6TH EDITION 

There follows a catalogue of significant, mostly incompati- 
ble, changes that will affect old users converting to the 
7th edition. No attempt is made to list all new facilities, 
or even all minor, but easily spotted changes, just the bare 
essentials without which it will be almost impossible to do 
anything. 

Addressing files . Byte addresses in files are now long 
(32-bit) "^integers. Accordingly seek has been replaced by 
lseek (2) . Every program that contains a seek must be modi- 
fied. Stat and fstat (2) have been affected similarly, since 
file lengths are now 32- rather than 24-bit quantities. 
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Assembly language . System entry points are no longer built 
in symbols. Their values must be obtained from 
/ usr / include / sys .s, see intro (2). All system calls modify 
rO. This means that sequences like 

mov file,rO 
sys lseek,0,0,2 
sys write,buf,n 

will no longer work. (In fact, Iseek now modifies rl as 
well, so be doubly cautious.) 

The sleep (2) entry point is gone; see the more general 
facility, alarm , plus pause . 

Few library functions have assembly language entry points 
any more. You will have to simulate the C calling sequence. 

Stty and gtty . These system calls have been extensively 
altered, see ioctl (2) and tty (4) . 

Archive files . The format of files produced by ar(l) has 
been altered. To convert to the new style, use arcv (l) . 

C language , lint . The official syntax for initialization 
requires an equal sign = before an initializer, and brackets 
{ } around compound initial values; arrays and structures 
are now initialized honestly. Two-address operators, such 
as =+ and =-, are now written += and -= to avoid ambigui- 
ties, although the old style is still accepted. You will 
also certainly want to learn about 

long integers 

type definitions 

casts (for type conversion) 

unions (for more honest storage sharing) 

tinclude <filename> (which searches in standard places) 

The program lint (l) checks for obsolete syntax and does 
strong type checking of C programs, singly or in groups that 
are expected to be loaded together. It is indispensable for 
conversion work. 

Fortran . The old fc is replaced by f77, a true compiler 
for Fortran 77, compatible with C. There are substantial 
changes in the language; see 'A Portable Fortran 77 Com- 
piler' in Volume 2. 
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stream editor . The program sed (l) is adapted to massive, 
repetitive editing jobs of the sort encountered in convert- 
ing to the new system. It is well worth learning. 

Standard l^/O. The old fopen , getc , putc complex and the 
old -l£ package are both dead, and even getchar has changed. 
All have been replaced by the clean, highly efficient, 
stdio O) package. The first things to know are that 
getchar O) returns the integer EOF (-1), which is not a pos- 
sible byte value, on end of file, that 518-byte buffers are 
out, and that there is a defined FILE data type. 

Make . The program make (l) handles the recompilation and 
loading of software in an orderly way from a 'makefile' 
recipe given for each piece of software. It remakes only as 
much as the modification dates of the input files show is 
necessary. The makefiles will guide you in building your 
new system. 

Shell , chdir. F. L. Bauer once said Algol 68 is the 
Everest that must be climbed by every computer scientist 
because it is there. So it is with the shell for ULTRIX-11 
users. Everything beyond simple command invocation from a 
terminal is different. Even chdir is now spelled cd. You 
will want to study sh(l) long and hard. 

Debugging . Adb(l) is a far more capable replacement for 
the debugger db. The first-time user should be especially 
careful about distinguishing / and ? in adb commands, and 
watching to make sure that the x whose value he asked for is 
the real x, and not just some absolute location equal to the 
stack offset of some automatic x. You can always use the 
'true' name, _x, to pin down a C external variable. 

Dsw . This little-known, but indispensable facility has been 
taken over by rm -ri . 

Boot procedures . Needless to say, these are all different. 
For further information, read Chapter 3 in the 'ULTRIX-11 
System Management Guide'. 
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SECTION 1. COMMANDS 

ac(l) login accounting 

accton(l) system accounting; see sa(l) 

adbd) debugger 

admind) create and administer SCCS files 

ar(l) archive and library maintainer 

arcv(lm) convert archives to new format 

as ( 1 ) assembler 

at(l) execute commands at a later time 

awk(l) pattern scanning and processing language 

bas(l) basic 

basename(l) ... .strip filename affixes 

bed) arbitrary-precision arithmetic language 

bdiff (1) big diff 

bufstatdm) print I/O buffer usage 

cald) print calendar 

calendar ( 1 ) . . . . reminder service 

catd) catenate and print 

cbd) C program beautif ier 

ccd) C compiler 

ccdd) crash dump analysis; see cdad) 

cdd) change working directory 

cda(lm) crash dump analysis 

cdc(l) change the delta commentary of an SCCS delta 

checkeqd) typeset mathematics; see eqn(l) 

chfnd) change finger entry 

chgrpd) change owner or group; see chown(l) 

chmodd) change mode 

chogd) change owner and group 

chownd) change owner or group 

chrootd) change root directory 

chshd) change default login shell 

clridm) clear i-node 

cmp(l) compare two files 

col(l) filter reverse line feeds 

combd) combine SCCS deltas 

commd) select or reject lines common to two sorted files 

cpio{l) copy file archives in and out 

csfdm) simplify special file creation 

cshd) a shell (command interpreter) with C-like syntax 

ctagsd) create a tags file 

cu_v7m(lc) call UNIX (V7M version) 

custat_v7m(lc) .call UNIX (V7M version); see cu_v7m(l) 

cutd) cut out selected fields of each line of a file 

dated) print and set the date 

dc (1 ) desk calculator 

dcheck(lm) file system directory consistency check 

dcopy(lm) copy file systems for optimal access time 

ddd) convert and copy a file 
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^®J^fUj; "^^^^ ^ delta (change) to an SCCS fil, 

2!T?£f^^^ ^?"'?^! "^°"' troff, tbl and eon com 




df(lm) .disk freT"' '"'^^^' """ """ ^"^^ constructs 

^jJJUJ: differential file comparator 

S'nf^-^^ ^"^^y differential file comparison 

^^^-i-j"- summarize disk usage 

dumpUm incremental file system dump 

f^o??[ ^^••••^''^''^ ^^^ "^"'^^ °^ ^il" °"^ dump tape 
ecno \.i) echo argijments 

ed(l) text editor 

®dit(l). text editor; see ex(l) 

^H^?P^' f^^rch a file for a pattern; see grep(l) 

eqn(l) typeset mathematics ^ 

ex(l) text editor 

??Pf{V evaluate arguments as an expression 

l_'}^'::: Fortran 77 compiler 

generate large primes 
ilues; see true(l) 

)r a pattern; see grep(l) 

_^ type 

find(l) find files 

finger(l) user information lookup program 

^P^'""^^"*^ ^?POft or change the status of floating point 

simulation 
from(l) who is my mail from? 

fslblS:::::::liil mit: S^l^r^ ^"-^ -^ interactive repair 

^^^^!,*': ^^^ ^ version of an SCCS file 

graph (Ig) draw a graph 

H^fPiJ! search a file for a pattern 

helpCl) ask for help 

i?heck??m)^*"*??? °' ^'^"' "^"'^ °^ ^^""^"t ^°^t system 

?n?ronf i^ ^y^^^"^ storage consistency check 

introu;.. introduction to commands 

lostat(lm) report I/O statistics 

ipatch(lm) print/modify contents of an inode 

J?J{^}^ relational database operator 

^^iI^•:^•^ terminate a process with extreme preiudice 

IdU)'!. l:::::ioader''^ ^'^^'^'"^ ""'^^ ^^^^^ checking; see volcopy(l) 
J-®^T"(^^ computer aided instruction about Unix 

Jf!!;) ; generator of lexical analysis program 

■•■i^tu; a C program verifier 

ln(l) make a link 

login(l) sign on 

logins(lm) enable user logins 

J°°!^i^j';-! fi"^d lines in a sorted list 

'°'"'^'''^'^ sefre?erUr' '^'^"^^^^^ references in documents; 

WU^^^ ^i^d ordering relation for an object library 

J-Pqj J °^ Imeprinter queue 

|P^^1'- line printer spooler 

iSo^wi N delete jobs from the lineprinter queue 

IPset(lm) set line printer parameters 



ams 
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ls(l) list contents of directory 

mlKl) Macro-11 assembler for UNIX 

m4 ( 1 ) macro processor 

mail(l) send or receive mail among users 

mail(l) send and receive mail 

make(l) maintain program groups 

man(l) print sections of this manual 

memstat(lm) ... .print memory usage map 

mesg(l) permit or deny messages 

mkconfdm) generate configuration tables 

mkdir(l) make a directory 

mkfs(lm) construct a file system 

mknod(lm) build special file 

mkstr(l) create an error message file by massaging C source 

more(l) file perusal filter for crt viewing 

mountdm) mount and dismount file system 

msf(l) simplify special file creation; see csf(l) 

mv(l) move or rename files and directories 

ncheck(lm) generate names from i-nxombers 

neqn(l) typeset mathematics; see eqn(l) 

newgrpd) log in to a new group 

niced) run a command at low priority 

nmd) print name list 

nohupd) run a command at low priority; see niced) 

nroffd) text formatting and typesetting 

odd) octal dxomp 

osloaddm) load optional software on Micro/PDP-11 

paged) file perusal filter for crt viewing; see more(l) 

passwdd) change login password 

pasted) merge same lines of several files or subsequent 

lines of one file 

peed) C compiler; see cc(l) 

plotdg) graphics filters 

prd) print file 

prepd) prepare text for statistical processing 

primesd) factor a number, generate large primes; 

see factord) 
printenvd) ... .print out the environment 

profd) display profile data 

prsd) print an SCCS file 

psd) process status 

pstatdm) print system facts 

ptx(l) permuted index 

pwdd) working directory name 

quot(lm) summarize file system ownership 

ranlibd) convert archives to random libraries 

rasizedm) report on MSCP disk partition sizes 

ratford) rational Fortran dialect 

referd) find and insert literature references in documents 

reniced) oppress running processes 

reset (1) set terminal modes; see tset(l) 

restordm) incremental file system restore 

revd) reverse lines of a file 

rm(l) remove (unlink) files 
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mtlnl '■^"'°''^ J ^^^^^ ^^°"^ ^"^ sees file 

raM(\] 1^'^°''^ (unlink) files; see rm(l) 

^oi^f^l> format text 

ci?f""\^^"'^ ^°'""'^^ ^°2 floppy diskettes 

^®^-'-'?\- system accounting 

srr^Hlff?iT***P'''"^ current SCCS file editing activity 
JcrinJn ^••••'^TP^'"^ ^^° versions of an SCCS file ^ 

sedm ""f^ typescript of terminal session 

^®^^|^ stream editor 

^*^ ( ^ I command language 

^J^®4i\ ^^^® °^ ^" object file 

^iJf?;t^ suspend execution for an interval 

^°^5^Jf^- sort or merge files 

spell (1). find spelling errors 

spellin(l). find spelling errors; see soelKl) 

Kfii^y?^!^*---^^'^^ "P^^^^"^ errors see spill ! 

sPj^J^fflg) interpolate smooth curve 

^P^^^^l •• split a file into pieces 

^^^'"^^^^^ ^i;;^ the printable strings in an object, or 

other binary file 

stJi'^i} ; ^f'^o^e symbols and relocation bits 

struct 1) structure Fortran programs 

stty 1) set terminal options 

fj;4,': substitute user id temporarily 

^^^^i'- sum and count blocks in a file 

syncllm) update the super block 

sysgen Im) ULTRIX-11 system generation 

t^ys 1 set terminal tabs 

III};}' deliver the last part of a file 

^"'^J-'-^ tape archiver 

l'^]\V format tables for nroff or troff 

7 ).,, : phototypesetter simulator 

teem; interactive 

t®e(l)' pipe fitting 

t?st(l) condition command 

tp®(lj time a command 

^^P;^^^ connect to a remote system 

JJ;,ii::: paginator for the Tektronix 4014 

:°^^^^-^^ update date last modified of a file 

l^);l manipulate tape archive 

^^^ J;- • • translate characters 

J^°5fU text formatting and typesetting 

t'^^^J-'-J provide truth values 

tset(l). set terminal modes 

tsort(l) topological sort 

Ift}}"^^ ^ist TTY structure assignments 

tf^yjl) get terminal name 

^■'•(-'•'•v* do underlining 



;;;;°eta)^ S'.^"^ dismount file system; see mount(l) 

^"?^^4^ ^"do a previous get of an SCCS file 

,'^^JJ4]: '^ePO'^t repeated lines in a file 

unitsvi; conversion program 

"^llli]]-) ULTRIX-11 System Acceptance Test 

^^^""^^^f compact list of users who are on tl 



;he system 
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uucpdc) Unix to unix copy 

uulog(lc) unix to unix copy; see uucp{l) 

uux(lc) unix to unix command execution 

val(l) validate SCCS file 

vc(l) version control 

vi(l) screen oriented (visual) display editor 

based on ex 
volcopy(lm) . . . .copy file systems with label checking 

waitd) await completion of process 

wall(lm) write to all users 

wc(l) ...word count 

what(l) identify SCCS files 

who(l) who is on the system 

whoami(l) print effective current user id 

write(l) write to another user 

xstr(l) extract strings from C programs to implement 

shared strings 

yacc(l) yet another compiler-compiler 

zaptty(lm) run a program without a controlling terminal. 



6 Table of Contents 



SECTION 2. SYSTEM CALLS 



access(2) determine accessibility of file 

acct(2) turn accounting on or off 

^^^''"'i^j schedule signal after specified time 

Z^fJ^l change core allocation; see brk(2) 

t*rk(2) change core allocation 

chdir(2) change default directory 

chmod(2) change mode of file 

chown(2) change owner and group of a file 

chroot(2) change default directory; see chdir(2) 

close(2) close a file 

creat(2) create a new file 

^^P;^2). duplicate an open file descriptor 

dup2(2).... duplicate an open file descriptor; see duD(2) 

environ (2) execute a file; see exec{2) 

^^^^°j^^^ introduction to system calls and error numbers 

exec(2) execute a file 

exece{2) execute a file; see exec(2) 

execl(2) execute a file; see exec(2) 

execle(2) execute a file; see exec(2) 

execlp(2) execute a file; see exec(2) 

execv(2) execute a file; see exec(2) 

execve(2) execute a file; see exec(2) 

execyp{2) execute a file; see exec(2) 

exit(2) terminate process 

fork (2) spawn new process 

fperr(2) get floating point error status 

fpsim(2) report or change the status of floating point 

simulation 

fstat(2) get file status; see stat(2) 

ftime(2) get date and time; see time{2) 

5^5®^-^!o! ^®^ ^^^^ ^"^ 5^°"P identity; see getuid(2) 

9®5®V^f;r 9et user and group identity; see getuid(2) 

getgidUK. get user and group identity; see getuid(2) 

getpgrp(23) set/get process group; see setpgrp{2) 

getpid(2) get process identification 

getppid (2) get process identification; see getpid(2) 

getuid(2) get user and group identity 

ghostname(2) . ..get/set name of current host 

gtty(2) control device; see ioctl(2) 

indir(2) indirect system call 

^'^^l°\l\ introduction to system calls and error numbers 

ioctl(2) control device 

•^ill ^2) send signal to a process 

killpg(2j) send signal to a process or a process group 

link(2) link to a file ^ f 

lock(2). lock a process in primary memory 

lseek(2) move read/write pointer 

mknod(2) make a directory or a special file 
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mount(2) mount or remove file system 

nice(2) set program priority 

nostk(2) allow process to manage its own stack 

open{2) open for reading or writing 

pause{2) stop until signal 

phys(2) allow a process to access physical addresses 

pipe(2) create an interprocess channel 

profil(2) execution time profile 

ptrace (2) process trace 

read{2) read from file 

renice(2) set program priority 

sbrk(2) change core allocation; see brk(2) 

setgid{2) set user and group ID; see setuid(2) 

setpgrp(2j )... .set/get process group 

setuid(2) set user and group ID 

shostname(2) .. .get/set name of current host; see ghostname(2) 

signal(2) catch or ignore signals 

sigsys(2j) catch or ignore signals 

stat(2) get file status 

stime(2) set time 

stty(2) control device; see ioctl(2) 

sync ( 2 ) update super-block 

tell(2) move read/write pointer; see lseek(2) 

time(2) get date and time 

times(2). get process times 

iamask(2) set file creation mode mask 

umount(2) mount or remove file system; see mount (2) 

unlink(2) remove directory entry 

utime(2) set file times 

wait(2) wait for process to terminate 

wait2(2j) wait for process to terminate 

write(2) write on a file 

zaptty(2) zap the controlling tty 
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SECTION 3. SUBROUTINES 

abort (3) generate lOT fault 

3bs(3) integer absolute value 

acos{3)... trigonometric functions; see sin(3m) 

Jc?nM? ^ convert date and time to ASCII; see ctime(l) 

asin(3 trigonometric functions; see sin(3m) 

assert(3x) program verification 

^l^^iV-^l trigonometric functions; see sin(3m) 

^^^r/ix trigonometric functions; see sin{3m) 

3tof(3) convert ASCII to numbers 

^5°,^^ convert ASCII to numbers; see atof(3) 

^t°^i^( convert ASCII to numbers; see atof(3) 

^ 1? hj euclidean distance; see hypot{3m) 

^^•i??i "^^^^ memory allocator; see malloc(3) 

^^^^^^) absolute value, floor, ceiling functions; 

see floor (3m) 
clearerr(3) ... .stream status inquiries; see ferror(3) 

•^^^^fj- trigonometric functions; see sin(3m) 

^°s"^^). hyperbolic functions; see sinh(3m) 

^fyP^^ a one way hashing encryption algorithm 

ctime(3). convert date and time to ASCII 

dhmfnfwi; ^""l^^u ^^"^tions with "optimal" cursor motion 

dbminit(3) data base subroutines; see dbm(3x) 

delete(3) data base subroutines; see dbm(3x) 

ecvt(3) output conversion 

edata(3).. last locations in program; see etext(3) 

encrypt(3) a one way hashing encryption algorithm; 

see crypt (3) 

®"^(3) last locations in program 

endgrent(3) get group file entry; see getgrent(3) 

endpwent(3) get password file entry; see getpwent(3) 

etextU) last locations in program 

!^P^?? exponential, logarithm, power, square root 

^®°^^-^^ absolute value, floor, ceiling functions; 

see floor (3m) 

fclose(3s) close or flush a stream 

fcvt(3) output conversion; see ecvt(3) 

fdopen(3) open a stream; see fopen(3s) 

feof(3)... stream status inquiries; see ferror(3) 

terror(3s) stream status inquiries 

I^^^^IV^: ^^^3 ^^^^ subroutines; see dbm(3x) 

J l^^/ix ^^°^® °^ ^^^^^ ^ stream; see fclose(3s) 

J^f^^^ ^et character or word from stream; see getc(3s) 

f^? /oA ^ ^ string from a stream; see fgets(3m) 

tiienou .. stream status inquiries; see ferror(3) 

tirstkey(3) data base subroutines; see dbm(3x) 

floor 3m absolute value, floor, ceiling functions 

fopen(3s) open a stream 

fprintf(3) formatted output conversion; see printf(3s) 
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fputcO) put character or word on a stream; see putcOs) 

fputsO) put a string on a stream; see putsOs) 

freadOs) buffered binary input/output 

freeO) main memory allocator; see mallocO) 

freopenO) open a stream; see fopenOs) 

frexpO) split into mantissa and exponent 

fscanfO) formatted input conversion; see scanfOs) 

fseekOs) reposition a stream 

ftell(3) reposition a stream; see fseekOs) 

fwriteO) buffered binary input/output; see freadOs) 

gcd{3) multiple precision integer arithmetic; 

see mp(3x) 

gcvtO) output conversion; see ecvtO) 

getcOs) get character or word from stream 

getcharO) get character or word from stream; see getcOs) 

getenvO) value for environment name 

getgrentO) . . . .get group file entry 
getgrgidO) . . . .get group file entry; see getgrentO) 
getgrnamO) . . . .get group file entry; see getgrentO) 
getloginO) . . . .get login name 

getpassO) read a password 

getpwO) get name from UID 

getpwentO) . . . .get password file entry 

getpwnamO) . . . .get password file entry; see getpwentO) 

getpwuidO) . . . .get password file entry; see getpwentO) 

getsOs) get a string from a stream 

getwO) get character or word from stream; 

see getcOs) 

gmtimeO) convert date and time to ASCII; see ctime(l) 

hypotOm) euclidean distance 

indexO) string operations; see stringO) 

introO) introduction to library functions 

introOj) summary of job control facilities 

isalnumO) character classification; see ctypeO) 

isalphaO) character classification; see ctype(3) 

isasciiO) character classification; see ctype(3) 

isatty(3) find name of a terminal; see ttynameO) 

iscntrl(3) character classification; see ctypeO) 

isdigit(3) character classification; see ctypeO) 

islowerO) character classification; see ctypeO) 

isprint(3) character classification; see ctypeO) 

ispunct(3) character classification; see ctype(3) 

isspaceO) character classification; see ctypeO) 

isupper(3) character classification; see ctype(3) 

itomO) multiple precision integer arithmetic; 

see mp(3x) 

j0(3m) bessel functions 

jl(3) bessel functions; see j0(3m) 

jn(3) bessel functions; see j0(3m) 

13tol{3) convert between 3-byte integers and long integers 

ldexp(3) split into mantissa and exponent; see frexpO) 

localtime(3) .. .convert date and time to ASCII; see ctime(l) 
logO) exponential, logarithm, power, square root; 

see exp(3m) 
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^°9lO(3) exponential, logarithm, power, square roof 

see exp(3m) 
longjmp(3) non-local goto; see setjmpO) 

^*'°^^^^' convert between 3-byte integers and long integers; 

see 13tol(3) ^ 

"IJff ^^l; multiple precision integer arithmetic; see mp{3x) 

malloc(3) mam memory allocator 

";*?iyi?^ multiple precision integer arithmetic; see mp(3x) 

mi^l^i.;;; muUiple precision integer arithmetic; see mp(3x) 

^??? ® ^ unique file name; see malloc(3) 

modf(3)... split into mantissa and exponent; see frexp(3) 

monitor(3) prepare execution profile 

"*°"ii^! multiple precision integer arithmetic; see mp(3x) 

T^^iil multiple precision integer arithmetic; see mp(3x) 

»^^i ;;; multiple precision integer arithmetic; see mp(3x) 

nextkey(3) data base subroutines; see dbm(3x) 

nlist(3) get entries from name list 

pclose(3) initiate I/O to/from a process; see popen(3s) 

perror(3) system error messages 

Pj^^^?se(3) packet driver simulator; see pkopen(3) 

pkfail{3) packet driver simulator; see pkopen(3) 

pkopen(3) packet driver simulator 

pkread(3). packet driver simulator; see pkopen(3) 

pkwrite(3) packet driver simulator; see pkopen(3) 

plot(3x) graphics interface 

popen(3s) initiate I/O to/from a process 

P°^^3) exponential, logarithm, power, square root- 
see exp(3m) 

SSTl^i;;*^ multiple precision integer arithmetic; see mp(3x) 

printf(3s) formatted output conversion 

putc(3s).. put character or word on a stream 

putchar 3) put character or word on a stream; see putc(3s) 

puts(3s) put a string on a stream 

P^^^^if put character or word on a stream; see putc(3s) 

qsort(3) quicker sort 

rand ( 3 ) random number generator 

realloc(3) main memory allocator; see malloc(3) 

rewind(3) reposition a stream; see fseek(3s) 

rindex(3) string operations; see string(3) 

SSnf?k^ multiple precision integer arithmetic; see mp(3x) 

scanf(3s) formatted input conversion 

setbuf(3s) assign buffering to a stream 

setgrent(3) get group file entry; see getgrent(3) 

setjmpO) non-local goto 

setpwent(3) get password file entry; see getpwent(3) 

sighold(3) manage signals; see sigset(3j) 

sigignore(3) .. .manage signals; see sigset(3j) 

signal{3) manage signals; see sigset(3j) 

s igpause( 3) ... .manage signals; see sigset(3j) 
sigrelse( 3) ... .manage signals; see sigset(3j) 

sigset(3j) manage signals 

sin(3m) trigonometric functions 

sinh(3m) hyperbolic functions 

sleep(3) suspend execution for interval 



Table of Contents 11 



sprintfO) formatted output conversion; see printfOs) 

sqrtO) exponential, logarithm, power, square root; 

see expOm) 

srandO) random number generator; see rand(3) 

sscanfO) formatted input conversion; see scanfOs) 

stdioOs) standard buffered input/output package 

store(3) data base subroutines; see dbm(3x) 



stringO) 
stringO) 
StringO) 
StringO) 
StringO) 
StringO) 
StringO) 

see perrorO) 
see perrorO) 



strcatO) string operations; see 

strcmpO) string operations; see 

strcpyO) string operations; see 

strlenO) string operations; see 

strncatO) string operations; see 

strncmpO) string operations; see 

strncpyO) string operations; see 

swabO) swap bytes 

sys_err list (3) .system error messages; 
sys_nerr( 3) ... .system error messages; 

system(3) issue a shell command 

tan(3) trigonometric functions; see sin(3m) 

tanh(3) hyperbolic functions; see sinh{3m) 

tgetentO) terminal independent operation routines; 

see termlib(3) 
tgetflag{3) ... .terminal independent operation routines; 

see termlib(3) 
tgetniim(3) terminal independent operation routines; 

see termlib(3) 
tgetstr(3) terminal independent operation routines; 

see termlib(3) 
tgoto(3) terminal independent operation routines; 

see termlib(3) 
timezone( 3) ... .convert date and time to ASCII 
tputs(3) terminal independent operation 

see termlib{3) 

ttyname(3) find name of a terminal 

ttyslot(3) find name of a terminal; see ttyname(3) 

ungetc(3s) push character back into input stream 

y0{3) bessel functions; see j0(3m) 

yl(3) bessel functions; see j0(3m) 

yn{3) bessel functions; see j0{3m) 



see ctime(l) 
routines; 
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SECTION 4. SPECIAL FILES 



cat ( 4 ) phototypesetter interface 

5'^<?"'S*) DMll-BB (modem controller for DHll); see dh(4) 

dn(4) DN-11 ACU interface 

5?!*} DU-11 201 data-phone interface; see du(2) 

^Vj* DU-U 201 data-phone interface 

J^ J Third RH11/RH70 massbus disk controller; see hp(4) 

hk 4 RK611/RK06, RK07 moving-head disk ^ 

J™ * Second RH11/RH70 massbus disk controller; see hp(4) 

hs 4 RH11/RH70 - RS03, RS04 fixed-head disk 

Jt 4 RH11/RH70 - TM02/3 magtape controller 

hx(4) RX211/RX02 floppy disk 

kmem(4) core memory; see mem(4) 

lp(4) line printer 

nieni(4) core memory 

n»1^4). RH11/RH70 - MLll solid state disk 

newtty(4) summary of the 'new' tty driver 

null(4) data sink 

PJ«(4) packet driver 

^^S*) UDA50/RA60, RA80, RA81 Winchester disks; 

"^3 f UDA50/RA60, RA80, RABl Winchester disks 

^^[^'y: KLESI/RC25 Winchester disk; see ra(4) 

^^/^^(^) RQDX1/RD51/RD52 Winchester disk and RX50 floppy disk- 
see ra(4) ' 

rk(4) RK11/RK03 or RK05 disk 

rl(4) RLll/RLOl or RL02 disk 

^P\^l RP11/RP02 or RP03 moving-head disk 

tc(4) TC11/TU56 DECtape 

t"»S4) TMll - TU10/TE10/TS03 800 BPI magtape interface 

ts 4 TS11/TSV05 1600 BPI magtape interface 

If^^l: TS11/TSV05/TU80/TK25 1600 BPI magtape interface 

tty(4} general terminal interface 
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SECTION 5. FILE FORMATS AND CONVENTIONS 



a.out(5) assembler and link editor output 

acct(5) execution accounting file 

ar{5) archive (library) file format 

core(5) format of core image file 

cpio(5) format of cpio archive 

ddate(5) incremental dump format; see dump(5) 

dir(5) format of directories 

dump(5) incremental dump format 

environ(5) user environment 

filsys(5) format of file system voliime 

flblk(5) format of file system volume; see filsys(5) 

fstab(5) ..file system table 

gettytab(5) ... .terminal configuration data base 

group(5) group file 

ino(5) format of file system volume; see filsys(5) 

mtab(5) mounted file system table 

passwd(5) password file 

phones{5) remote host phone number data base 

plot(5) graphics interface 

printcap(5) ... .printer capability data base 

remote(5) remote host description file 

sccsfile(5) ... .format of an sees file 

tar(5) tape archive format 

termcap(5) terminal capability data base 

tp(5) DEC/mag tape formats 

ttys(5) terminal initialization data 

ttytype(5) terminal type data 

types{5) primitive system data types 

utmp(5) login records 

wtmp(5) login records; see utmp(5) 
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SECTION 6. GAMES 



arithinetic(6) . .provide drill in number facts 
backgammon ( 6 ) . . the game 

banner (6) make long posters 

bcd(6) convert to antique media 

bj(6) the game of black jack 

checkers(6) . . . .game 

chess(6) the game of chess 

ching(6) the book of changes and other cookies; see fortune(6) 

cubic(6) tic-tac-toe 

fortune(6) the book of changes and other cookies 

hangman(6) word games 

maze(6) generate a maze problem 

moo{6) guessing game 

Ppt(6) convert to antique media; see bcd(6) 

quiz(6) test your knowledge 

reversi(6) a game of dramatic reversals 

ttt{6) tic-tac-toe 

words(6) word games 

wump( 6 ) the game of hunt-the-wumpus 



SECTION 7. MACRO PACKAGES AND LANGUAGE CONVENTIONS 



ascii(7) map of ASCII character set 

eqnchar(7) special character definitions for 

greek(7) graphics for extended TTY-37 type- 

hier(7) file system hierarchy 

nian(7) macros to typeset manual 

nis{7) macros for formatting manuscripts 

terminals ( 7 ) . . . convent ional names 



eqn 
box 
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SECTION 8. MAINTENANCE 

boot ( 8 ) startup procedures 

crash(8) what to do when the system crashes 

cron(8) clock daemon 

dmesg(8) collect system diagnostic messages to form error log 

getty (8) set typewriter mode 

init(8) process control initialization 

lpd(8) line printer daemon 

makekey(8) generate encryption key 

rc(8) process control initialization 

shutdown(8) ... .orderly system shutdown 

ulf(8) universal lineprinter filter 

update(8) periodically update the super block 
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PERMUTED INDEX 



TS11/TSV05 1600 BPI magtape ts(4) 

convert between 3-byte integers and long 13tol(3) 

3-way differential file diff3(l) 

TMll - TU10/TE10/TS03 800 BPI magtape interface. .. .tm(4) 

DN-11 ACU interface dn{4) 

/convert date and t ime to ASCI I ct ime ( 3 ) 

map of ASCI I character set asc i i ( 7 ) 

convert ASCII to numbers atof(3) 

ULTRIX-11 System Acceptance Test usat(l) 

TMll - TU10/TE10/TS03 800 BPI magtape interface tm(4) 

TS11/TSV05 1600 BPI magtape interface ts(4) 

C compiler cc(l) 

C program beaut ifier cb(l) 

a C program verifier lint(l) 

extract strings from C programs to implement/ xstr(l) 

message file by massaging C source mkstrd) 

interpreter) with C-like syntax csh(l) 

DEC/mag tape formats tp(5) 

TC11/TU56 DECtape tc(4) 

DN-11 ACU interface dn(4) 

DU-11 201 data-phone du(4) 

Fortran 77 compiler f77(l) 

rational Fortran dialect ratfor(l) 

structure Fortran programs struct ( 1 ) 

set user and group ID setuid{2) 

print I/O buffer usage bufstat(lm) 

report I/O statistics iostat(lm) 

initiate I/O to/from a process popen(3s) 

generate lOT fault abort ( 3 ) 

RH11/RH70 - MLll solid State disk ml(4) 

report on MSCP disk partition sizes. .. .rasize(lm) 

Macro-11 assembler for mll(l) 

load optional software on Micro/PDP-11 osload{lm) 

UDA50/RA60, RA80, RA81 Winchester ra(4) 

UDA50/RA60, RA80, RA81 Winchester disks ra(4) 

RH11/RH70 - MLll solid ml(4) 

RH11/RH70 - RS03, RS04 hs(4) 

RH11/RH70 - TM02/3 ht(4) 

RK11/RK03 or RK05 disk rk(4) 

RK611/RK06, RK07 moving-head disk hk(4) 

RK11/RK03 or RK05 disk rk(4) 

RK611/RK06, RK07 hk(4) 

RLll/RLOl or RL02 disk rl(4) 

RLll/RLOl or RL02 disk rl(4) 

RP11/RP02 or RP03 moving-head disk rp(4) 
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RH11/RH70 - 

RH11/RH70 - RS03, 

format 



RH11/RH70 - 



list 

graphics for extended 

TMll - 

paginator for the 

System Acceptance 

get name from 



aided instruction about 
Macro-11 assembler for 

call 

call 

call UNIX (original 

call UNIX 

integer 

allow a process to 

file systems for optimal 

determine 

login 

system 

execution 

turn 

sees file editing 

to access physical 

create and 

strip filename 

computer 

way hashing encryption 

change core 

main memory 

crash dump 

generator of lexical 

convert to 

format of cpio 
manipulate tape 

tape 

tape 

copy file 

convert 

convert 



RPH/RP02 or RP03 rp(4) 

RS03, RS04 fixed-head hs(4) 

RS04 fixed-head disk hs(4) 

RX02 floppy diskettes rx2fmt(lm) 

RX211/RX02 floppy disk hx(4) 

TC11/TU56 DECtape tc ( 4 ) 

TM02/3 magtape controller ht(4) 

TMll - TU10/TE10/TS03 800 tm{4) 

TS11/TSV05 1600 BPI ts(4) 

TTY structure assignments tss(lm) 

TTY-37 type-box greek(7) 

TU10/TE10/TS03 800 BPI tm(4) 

Tektronix 4014 tk(l) 

Test usat ( 1 ) 

UDA50/RA60, RA80, RA81 ra(4) 

UID getpw{3) 

ULTRIX-11 System usat(l) 

ULTRIX-11 system sysgen(lm) 

UNIX learn(l) 

UNIX mll(l) 

UNIX (V7M version) cu_v7m(lc) 

UNIX (original V7 cu_v7(lc) 

V7 version) cu~v7(lc) 

(V7M version) cu_v7m(lc) 

absolute value abs ( 3 ) 

absolute value, floor, floor(3m) 

access physical addresses. .. .phys( 2) 

access time dcopy(lm) 

accessibility of file access(2) 

accounting ac(lm) 

accounting sa(lm) 

accounting file acct(5) 

accounting on or off acct(2) 

act ivi ty sact ( 1 ) 

addresses phys ( 2 ) 

administer SCCS admin(l) 

affixes basename(l) 

aided instruction about learn(l) 

algorithm crypt(3) 

allocation brk(2) 

allocator malloc(3) 

analysis cda ( Im) 

analysis programs lex(l) 

ant ique med i a bed ( 6 ) 

arbitrary-precision bc(l) 

archive cpio(5) 

archive tp(l) 

archive and library ar(l) 

archive format tar (5) 

archive (library) file ar(5) 

archiver tar(l) 

archives in and out cpio(l) 

archives to new format arcv(lm) 

archives to random ranlib(l) 
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echo 

evaluate 

precision integer 

arbi trary-prec is ion 

evaluate arguments 



Macro-11 

list TTY structure 

execute commands 

run a command 



configuration 

host phone number 

printer capability 

terminal capability 



(visual) 



data 
data 
data 
data 
data 
display editor 



C program 



in a object, or other 

buffered 

the game of 

update the super 

update the super 

sum and count 

the 

print I/O 

standard 
assign 

swap 

desk 

print 

indirect system 



introduction to system 

introduction to system 

printer 

terminal 



absolute value, floor. 



arguments echo ( 1 ) 

arguments as an expr(l) 

arithmetic mp(3x) 

arithmetic language bc( 1) 

as an express ion expr ( 1 ) 

ask for help help(l) 

assembler as ( 1 ) 

assembler and link editor. .. .a. out(5) 

assembler for UNIX mll(l) 

assign buffering to a setbufOs) 

assignments tss(lm) 

at a later time at(l) 

at low priority nice(l) 

await completion of wait(l) 

base gettytab(5) 

base phones ( 5 ) 

base printcap(5) 

base termcap ( 5 ) 

base subrout ines dbm( 3x ) 

based on ex vi(l) 

basic bas(l) 

beautif ier cb(l) 

bessel f unct ions j { 3m) 

big diff bdiff(l) 

binary, file strings(l) 

binary input/output f read(3s) 

black j ack bj ( 6 ) 

block syncdm) 

block update { 8 ) 

blocks in a file sum(l) 

book of changes and other. .. .ching(6) 

buffer usage bufstat(lm) 

buffered binary f read(3s) 

buffered input/output stdio{3s) 

buffering to a stream setbufOs) 

build special file mknod(lm) 

bytes swab ( 3 ) 

calculator dc(l) 

calendar cal(l) 

call indir(2) 

call UNIX (V7M version) cu_v7m(lc) 

call UNIX (original V7 cu_v7(lc) 

calls and error numbers errno(2) 

calls and error numbers intro(2) 

capability data base printcap(5) 

capability data base termcap(5) 

catch or ignore signals signal(2) 

catch or ignore signals sigsys(2j) 

catenate and print cat ( 1 ) 

ceiling functions floor (3m) 

change core allocation brk(2) 

change default directory chdir(2) 

change default login chsh(l) 

change finger entry chfn(l) 
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report or 

report or 

make a delta 

the book of 
create an interprocess 

push 

special 

get 

put 

map of ASCII 

translate 

directory consistency 

storage consistency 

file system consistency 

file systems with label 

file systems with label 

the game of 

character 



issue a shell 

condition 

time a 

run a 

Unix to unix 

a shell 

introduction to 

execute 

change the delta 

select or reject lines 

differential file 



3-way differential file 

C 

Fortran 77 

yet another 

await 



change login password passwd(l) 

change mode chmodd) 

change mode of file chmod(2) 

change owner and group chog(l) 

change owner and group of chown(2) 

change owner or group chown{l) 

change root directory chrootd) 

change the delta cdc(l) 

change the status of fpsim(lm) 

change the status of fpsim(2) 

(change) to an/ delta(l) 

change working directory cd(l) 

changes and other cookies. .. .ching(6) 

channel pipe ( 2 ) 

character back into input ungetcOs) 

character classification ctypeO) 

character definitions for. . . .eqnchar(7) 

character or word from getcOs) 

character or word on a putc{3s) 

character set asci i ( 7 ) 

characters tr(l) 

check dcheck(lm) 

check icheck(lm) 

check and interactive/ fsck(lm) 

checking label it ( 1) 

checking volcopy(lm) 

chess chess ( 6 ) 

classification ctype(3) 

clear i-node clri { Im) 

clock daemon cron(8) 

close a file close(2) 

close or flush a stream fclose(3s) 

collect system diagnostic. .. .dmesg(8) 

combine SCCS comb(l) 

command system(3) 

command test ( 1 ) 

command t ime ( 1 ) 

command at low priority nice(l) 

command execution uux(lc) 

(command interpreter) csh(l) 

command language sh( 1) 

commands i nt ro ( 1 ) 

commands at a later time at(l) 

commentary of an/ cdc(l) 

common to two sorted/ comm(l) 

compact list of users who users(l) 

comparator dif f (1) 

compare two files cmp(l) 

compare two versions of sccsdiff(l) 

comparison diff3(l) 

compiler cc(l) 

compiler f77(l) 

compiler-compiler yacc(l) 

completion of process wait(l) 
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computer aided learn( 1) 

condition command test ( 1) 

terminal configuration data base gettytab(5) 

generate configuration tables mkconf(lm) 

file system directory consistency check dcheck(lm) 

file system storage consistency check icheck(lm) 

file system consistency check and fsck(lm) 

construct a file system mkfs(lm) 

nroff, troff, tbl and eqn constructs.. deroff(l) 

print/modify contents of an inode ipatch(lm) 

list contents of directory ls(l) 

version control vc(l) 

control device ioctl(2) 

summary of job control facilities introOj) 

process control initialization init(8) 

/process control initialization rc(8) 

- TM02/3 magtape controller ht(4) 

run a program without a controlling terminal zapttydm) 

zap the controlling tty zaptty(2) 

conventional names terminals(7) 

output convers ion ecvt ( 3 ) 

formatted output conversion printf {3s) 

formatted input conversion scanf(3s) 

conversion program units(l) 

convert ASCI I to numbers atof ( 3 ) 

convert and copy a file dd(l) 

convert archives to new arcv(lm) 

convert archives to ranlibd) 

convert between 3-byte 13tol{3) 

convert date and time to ctime(3) 

convert to antique media bcd(6) 

book of changes and other cookies ching(6) 

unix to unix copy uucp(lc) 

convert and copy a file dd(l) 

copy file archives in and. . . .cpio(l) 

copy file systems for dcopydm) 

copy file systems with labelit(l) 

copy file systems with volcopy(lm) 

change core allocation brk(2) 

format of core image file core(5) 

core memory mem(4) 

word count wc ( 1 ) 

sum and count blocks in a file sum(l) 

format of cpio archive cpio(5) 

crash dump analysis cda(lm) 

to do when the system crashes crash(8) 

create a new file creat(2) 

create a tags file ctags(l) 

create an error message mkstr(l) 

create an interprocess pipe(2) 

create and administer admin(l) 

simplify special file creation csf(lm) 

set file creation mode mask umask{2) 

file perusal filter for crt viewing more(l) 
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get/set name of current host ahostname(2) 

set or print name of current host system hostname(l) 

print current SCCS file sact(l) 

^w??i "^i^-^'T» ^^^^^'^t user id whoami(l) 

with "optimal" cursor motion curse^in) 

interpolate smooth curve !!spline(lq) 

cut out selected fields! .*.*.*.' !cut{l) 

clock daemon cron(8) 

line printer daemon lDd(8) 

display profile data Drof(i) 

terminal initialization data ttvs(5) 

terminal type data '.'.'.'.'.'.'.'.'.'.'.'.'.ttytweiS) 

terminal configuration data base aettvfah?^^ 

remote host phone number data base Dhones?5 

printer capability data base ',',',,', 'nrintcan 5) 

terminal capability data base ,, ! termcap?5) 

data base subroutines dbm(3x) 

. .^. <53ta sink null(4) 

primitive system data types types(5) 

relational database operator !!!join(l) 

DU-11 201 data-phone interface du(4) 

print and set the date date(l) 

get date and time ! ! ! ! !ftime(2) 

get date and time time(2) 

/convert date and time to ASCII ctimeO) 

update date last modified of a touch(l) 

^■1 . debugger adb{l) 

file system debugger fsdb(lm) 

change default directory chdir(2) 

change default login shell chsh(l) 

special character definitions for eqn eqnchar(7) 

delete jobs from the Iprm(l) 

deliver the last part of tail(l) 

of an SCCS delta cdc{l) 

make a delta (change) to an. .!!!!!! ]delta{l) 

change the delta commentary of an cdc(l) 

remove a delta from an rmdel(l) 

combine SCCS deltas !.*!comb(l) 

permit or deny messages !!!!!! !mesq ( 1 ) 

remote host description file remote(5) 

duplicate an open file descriptor duD(2) 

duplicate an open file descriptor .*!.*!.*.* !dup2 (2) 

desk calculator !dc(l) 

determine accessibility access(2) 

determine file type filed) 

control device ioctl(2) 

collect system diagnostic messages to. ! ! ! ! ! !dmesq(8) 

"^ig ^iff bdiff(l) 

differential file diff(l) 

3-way differential file diff3{l) 

format of directories dir(5) 

move or rename files and directories !!!!!mv(l) 

change working directory .*.*.*.* cd(l) 

change default directory !.*!!!!.*! .*chdir(2) 
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change root 

list contents of 

make a 

file system 

remove 

working 

make a 

RK07 moving- head 

- RS03, RS04 fixed-head 

RX211/RX02 floppy 

- MLll solid state 

RK11/RK03 or RK05 

RLll/RLOl or RL02 

or RP03 moving-head 

report on MSCP 

svimmarize 

format RX02 floppy 

RA80, RA81 Winchester 

mount and 

screen oriented (visual) 

euclidean 

literature references in 

a game of 

provide 
summary of the 'new' tty 

packet 

packet 

incremental file system 

octal 

crash 

incremental 

the names of files on a 



out selected fields of 

current SCCS file 

text 

text 

stream 

/oriented (visual) display 

assembler and link 

print 

a one way hashing 

generate 

get 

change finger 

get group file 

get password file 

remove directory 



directory chroot(l) 

directory ls(l) 

directory mkdir(l) 

directory consistency dcheck(lm) 

directory entry unlink(2) 

directory name pwd(l) 

directory or a special mknod(2) 

disk hk(4) 

disk hs(4) 

disk hx(4) 

disk ml (4) 

disk rk ( 4 ) 

disk rl(4) 

disk rp(4) 

disk free df (Im) 

disk partition sizes rasize(lm) 

disk usage du ( 1) 

diskettes rx2fmt(lm) 

disks ra(4) 

dismount file system mount (Im) 

display editor based on/ vi(l) 

display profile data prof(l) 

distance hypotOm) 

documents refer(l) 

dramatic reversals reversi(6) 

draw a graph graph(lg) 

drill in number facts arithmetic(6) 

driver newtty(4) 

driver pk(4) 

driver simulator pkopenO) 

dump dump(lm) 

dump od ( 1 ) 

dump analysis cda(lm) 

dump format dump ( 5 ) 

dump tape dumpdir(lm) 

duplicate an open file dup(2) 

duplicate an open file dup2(2) 

each line of a file cut(l) 

echo arguments echo(l) 

editing activity sact(l) 

editor ed(l) 

editor ex(l) 

editor sed(l) 

editor based on ex vi(l) 

editor output a. out (5) 

effective current user id. . . .whoami (1) 

enable user logins logins(lm) 

encryption algorithm cryptO) 

encryption key makekey(8) 

entries from name list nlistO) 

entry chfn(l) 

entry getgrent (3) 

entry getpwent ( 3 ) 

entry unlink(2) 
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user environment environ(5) 

print out the environment printenv(l) 

value for environment name qetenvO) 

character definitions for eqn eqnchar(7) 

nroff, troff, tbl and eqn constructs ! ! ! ! ! iderof f (1) 

messages to form error log dmesg(8) 

create an error message file by mkstr(l) 

system error messages perrorO) 

/to system calls and error n;jmbers errno(2) 

/to system calls and error numbers intro(2) 

get floating point error status !!!fperr(2) 

find spelling errors spell(l) 

euclidean distance hypot(3m) 

evaluate arguments as an expr(l) 

display editor based on ex vi(l) 

execute a file !!environ(2) 

execute a file exec(2) 

execute commands at a at ( 1 ) 

Unix to Unix command execution uux(lc) 

execut ion account ing file.... acct ( 5 ) 

suspend execution for an interval sleep(l) 

suspend execution for interval sleep(3) 

prepare execution profile monitor(3) 

execution time profile profil(2) 

split into mantissa and exponent frexp(3) 

exponential, logarithm, exp(3x) 

evaluate arguments as an expression expr(l) 

graphics for extended TTY-37 type-box greek(7) 

extract strings from C xstr(l) 

summary of job control facilities intro(3j) 

factor a number, generate. ... factor(l) 

generate lOT fault abort ( 3 ) 

cut out selected fields of each line of a cut(l) 

accessibility of file access{2) 

execution accounting file !!acct(5) 

change mode of file !!!!!! !chmod(2) 

owner and group of a file chown ( 2 ) 

close a file close(2) 

format of core image file core ( 5 ) 

create a new file !!!!creat(2) 

create a tags file !ctaqs(l) 

fields of each line of a file cut(l) 

convert and copy a file !!!!!!!!!!! dd(l) 

to an sees file ! ! ! ! ! !delta(l) 

execute a file [,', ;environ(2) 

execute a file exec(2) 

of an sees file ,,', get ( 1 ) 

group file !!!!group(5) 

link to a file link(2) 

build special file !!!mknod(lm) 

a directory or a special file mknod(2) 

password file ! ! ! ! !passwd(5) 

subsequent lines of one file paste(l) 

print file !!!! !pr(l) 
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print an SCCS 




read from 




remote host description 




reverse lines of a 




from an SCCS 




of an SCCS 




size of an object 




object, or other binary. 




sum and count blocks in a 




the last part of a 




date last modified of a 




get of an SCCS 




repeated lines in a 




validate SCCS 




write on a 




copy 




create an error message 




differential 




3-way differential 




simplify special 




set 




duplicate an open 




duplicate an open 




/current SCCS 




get group 




get password 




search a 




archive (library) 




split a 




make a unique 




get 


get 




construct a 




mount and dismount 




mount or remove 




mount or remove 




incremental 


summarize 


incremental 




mounted 




format of 




copy 




copy 




copy 




set 




determine 




strip 





ile prs(l) 

ile read{2) 

ile remote ( 5 ) 

ile rev(l) 

ile rmdel(l) 

ile sccsdif f (1) 

ile sized) 

ile strings(l) 

ile sum ( 1 ) 

ile tail(l) 

ile touch(l) 

ile unget(l) 

ile uniq(l) 

ile val(l) 

ile write(2) 

ile archives in and out cpio(l) 

ile by massaging C/ mkstr(l) 

ile comparator dif f (1) 

ile comparison diffid) 

ile creation csf (Im) 

ile creation mode mask umask(2) 

ile descriptor dup(2) 

ile descriptor dup2(2) 

ile editing activity sact(l) 

ile entry getgrentO) 

ile entry getpwentO) 

ile for a pattern grep(l) 

i le format ar ( 5 ) 

ile into pieces split(l) 

ile name mktempO) 

ile perusal filter for more(l) 

ile status fstat(2) 

ile status stat{2) 

ile system mkfs(lm) 

ile system mount (Im) 

ile system mount (2) 

ile system umount(2) 

ile system consistency fsck(lm) 

ile system debugger fsdb(lm) 

ile system directory dcheck(lm) 

ile system dump dump(lm) 

ile system hierarchy hier(7) 

ile system ownership quot(lm) 

ile system restore restor(lm) 

ile system storage icheck(lm) 

ile system table fstab(5) 

ile system table mtab(5) 

i le system volume f i Isys ( 5 ) 

ile systems for optimal dcopy(lm) 

ile systems with label labelit(l) 

ile systems with label volcopy(lm) 

i le t imes ut ime ( 2 ) 

ile type file(l) 

ilename affixes basenamed) 
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administer SCCS 

compare two 

common to two sorted 

find 

remove (unlink) 

sort or merge 

identify SCCS 

move or rename 

print the names of 

/same lines of several 

universal lineprinter 

file perusal 

graphics 



change 
RH11/RH70 - RS03, RS04 

get 

/or change the status of 

/or change the status of 

absolute value, 

RX211/RX02 

format RX02 

close or 

diagnostic messages to 

archive (library) file 

convert archives to new 

incremental dump 

tape archive 



DEC/mag tape 



who is 

value, floor, 

introduction to 



text 

macros for 

disk 

my mail 

ceiling 

library 

bessel 

trigonometric 

hyperbolic 



files admin(l) 

files cmp(l) 

files comm(l) 

files find(l) 

files rm(l) 

files sort(l) 

files what(l) 

files and directories mv(l) 

files on a dump tape dumpdir(lm) 

files or subsequent lines. .. .paste(l) 

filter ulf(8) 

filter for crt viewing more(l) 

filter reverse line feeds. .. .col(l) 

filters plot(lg) 

find and insert refer(l) 

find files find(l) 

find lines in a sorted look(l) 

find name of a terminal ttynameO) 

find ordering relation lorder(l) 

find spelling errors spell(l) 

find the printable strings(l) 

finger entry chfn(l) 

fixed-head disk hs(4) 

floating point error fperr(2) 

floating point simulation fpsim(lm) 

floating point simulation. ... fpsim(2) 

floor, ceiling functions floor(3m) 

floppy disk hx(4) 

floppy diskettes rx2fmt ( Im) 

flush a stream fcloseOs) 

form error log dmesg(8) 

format ar ( 5 ) 

format arcv ( Im) 

format dump ( 5 ) 

format tar ( 5 ) 

format RX02 floppy rx2fmt(lm) 

format of core image f ile. . . .core(5) 

format of cpio archive cpio(5) 

format of directories dir(5) 

format of file system filsys(5) 

format tables for nrof f tbl ( 1 ) 

format text rof f (1) 

formats tp(5) 

formatted input scanf ( 3s ) 

formatted output printf (3s) 

formatting and trof f (1) 

formatting manuscripts ms(7) 

free df ( Im) 

from? f rom( 1 ) 

functions floor(3m) 

functions intro(3) 

functions jO(3m) 

f unct ions s in ( 3m) 

functions sinh(3m) 
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screen functions with cursesO) 

the game backgammon ( 6 ) 

game checkers ( 6 ) 

guessing game moo(6) 

the game of black jack bj(6) 

the game of chess chess ( 6 ) 

a game of dramatic reversi{6) 

the game of hunt-the-wumpus wump(6) 

word games hangman ( 6 ) 

generate lOT fault abort ( 3 ) 

generate a maze problem maze(6) 

generate configuration mkconf (Im) 

generate encryption key makekey(8) 

factor a number, generate large primes factor(l) 

generate names from ncheck(lm) 

ULTRIX-11 system generat ion sysgen { Im) 

random nximber generator rand(3) 

generator of lexical lex{l) 

get/set name of current ghostname(2) 

non-local goto setjmpO) 

draw a graph graph(lg) 

graphics filters plot(lg) 

graphics for extended greek{7) 

graphics interface plotOx) 

graphics interface plot(5) 

change owner and group chog ( 1 ) 

change owner or group chown ( 1 ) 

to a process or a process group killpg(2j) 

log in to a new group newgrp(l) 

set/get process group setpgrp(2j) 

set user and group ID setuid(2) 

group file group(5) 

get group file entry getgrentO) 

get user and group identity getuid(2) 

change owner and group of a file chown(2) 

maintain program groups make(l) 

guessing game moo{6) 

a one way hashing encryption cryptO) 

ask for help helpd) 

file system hierarchy hier(7) 

get/set name of current host ghostname ( 2 ) 

remote host description file remote(5) 

remote host phone number data phones (5) 

or print name of current host system hostname(l) 

the game of hunt-the-wvmipus wump(6) 

hyperbolic functions sinh(3m) 

effective current user id whoami(l) 

substitute user id temporarily su(l) 

get process identification getpid(2) 

get process identification getppid{2) 

ident i f y SCCS what ( 1 ) 

get user and group identity getuid(2) 

catch or ignore signals signal(2) 

catch or ignore signals sigsys{2j) 
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format of core 
/from C programs to 



terminal 
permuted 

user 

process control 

/process control 

terminal 

clear 

contents of an 

formatted 

push character back into 

buffered binary 

standard buffered 

stream status 

find and 

computer aided 

/consistency check and 

photo typesetter 

DN-11 ACU 

DU-11 201 data-phone 

graphics 

graphics 

800 BPI magtape 

1600 BPI magtape 

general terminal 

general terminal 

a shell (command 
create an 



generate names from 

the game of black 

summary of 

delete 

generate encryption 

copy file systems with 

copy file systems with 

scanning and processing 

/arithmetic 

command 

generator of 

archives to random 

relation for an object 



image file core(5) 

implement shared strings xstr(l) 

incremental dump format dump(5) 

incremental file system dump(lm) 

incremental file system restor{lm) 

independent operation termlibO) 

index ptx(l) 

indirect system call indir(2) 

information lookup f inger(l) 

initialization init(8) 

initialization rc(8) 

initialization data ttys(5) 

initiate I/O to/from a popenOs) 

i-node clri(lm) 

inode ipatch(lm) 

input conversion scanf (3s) 

input stream ungetcOs) 

input/output freadOs) 

input/output package stdio(3s) 

inquiries ferrorOs) 

insert literature refer(l) 

instruction about UNIX learn(l) 

interactive ted(l) 

interactive repair fsck(lm) 

interface cat (4) 

interface dn(4) 

interface du(4) 

interface plot(3x) 

interface plot(5) 

interface tm(4) 

interface ts(4) 

interface tty(4) 

interface tty(4) 

interpolate smooth curve spline(lg) 

interpreter) with C-like csh(l) 

interprocess channel pipe(2) 

introduction to commands intro(l) 

introduction to library intro(3) 

introduction to system errno(2) 

introduction to system intro(2) 

i-numbers ncheck(lm) 

issue a shell command system(3) 

jack bj(6) 

job control facilities intro(3j) 

jobs from the lineprinter Iprm(l) 

l^ey makekey(8) 

label checking labelit(l) 

label checking volcopy(lm) 

language awk ( 1 ) 

language be ( 1 ) 

language sh(l) 

lexical analysis programs. ... lex(l) 

libraries ranlib(l) 

library lorder(l) 
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archive 

introduction to 

archive and 

filter reverse 

selected fields of each 



set 

universal 

show 

delete jobs from the 

select or reject 

report repeated 

find 

reverse 

/files or subsequent 

merge same 

make a 

assembler and 

find lines in a sorted 

get entries from name 

print name 



compact 
find and insert 



last 

messages to form error 

exponential, 

get 
change 

change default 

enable user 

user information 



RH11/RH70 - TM02/3 

TU10/TE10/TS03 800 BPI 

TS11/TSV05 1600 BPI 

send and receive 

send or receive 

who is my 



archive and library 



(library) file format ar(5) 

library functions intro(3) 

library maintainer ar(l) 

line feeds col(l) 

line of a file cut(l) 

line printer lp(4) 

line printer daemon lpd(8) 

line printer parameters Ipset(lm) 

line printer spooler Ipr(l) 

lineprinter filter ulf (8) 

lineprinter queue lpq( 1) 

1 inepr inter queue lprm( 1 ) 

lines common to two comm(l) 

lines in a file uniq(l) 

lines in a sorted list look(l) 

lines of a file rev(l) 

lines of one file paste(l) 

lines of several files or. . . .paste(l) 

link ln(l) 

link editor output a.out(5) 

link to a file link(2) 

list look(l) 

list nlist(3) 

list nmd) 

list TTY structure tss(lm) 

list contents of ls(l) 

list of users who are on users(l) 

literature references in/. . . .refer(l) 
load optional software on. . . .osload(lm) 

loader Id ( 1 ) 

locations in program end(3) 

lock a process in primary. ... lock( 2) 

log dmesg { 8 ) 

log in to a new group newgrp(l) 

logarithm, power, square exp(3x) 

login accounting ac(lm) 

login name getlogin{3) 

login password passwd(l) 

login records utmp{ 5) 

login shell chsh(l) 

logins log ins (Im) 

lookup program f inger(l) 

macro processor m4(l) 

macros for formatting ms(7) 

macros to typeset manual man(7) 

magtape controller ht{4) 

magtape interface tm{4) 

magtape interface ts(4 ) 

mail ma i 1 ( 1 ) 

mail among users mail(l) 

ma i 1 f rom? f rom ( 1 ) 

main memory allocator malloc(3) 

maintain program groups make{l) 

maintainer ar{l) 
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allow process to 



split into 

print sections of this 

macros to typeset 

macros for formatting 

set file creation mode 

/an error message file by 

typeset 
generate a 
to antique 
in primary 
core 
main 
print 
sort or 



convert 
lock a process 



create an error 

permit or deny 

system error 

collect system diagnostic 

change 

set typewriter 

set file creation 

change 

set terminal 

update date last 

with "optimal" cursor 



RK611/RK06, RK07 
RP11/RP02 or RP03 

who is 

value for environment 

get login 

make a unique file 

working directory 

get terminal 

get 

get entries from 



make a delta (change) to delta(l) 

make a directory mkdir(l) 

make a directory or a mknod(2) 

make a link ln(l) 

make a unique file name !mktemp(3) 

make long posters banner(6) 

make typescript of script(l) 

manage its own stack nostk(2) 

manage signals sigsetOj) 

manipulate tape archive tp(l) 

mantissa and exponent frexpO) 

nianual man ( 1 ) 

manual man ( 7 ) 

manuscripts ms(7) 

n»ask umask ( 2 ) 

massaging C source mkstr(l) 

mathematics eqn(l) 

maze problem ma2e(6) 

media bcd( 6 ) 

memory lock(2) 

memory mem( 4 ) 

memory allocator mallocO) 

memory usage map memstat ( Im) 

merge files sort(l) 

merge same lines of paste(l) 

message file by massaging mkstr(l) 

messages mesg(l) 

messages perrorO) 

messages to form error/ dmesg(8) 

mode chmod ( 1 ) 

mode get ty ( 8 ) 

mode mask umask { 2 ) 

mode of file chmod(2) 

modes tset { 1 ) 

modified of a file touch(l) 

motion cursesO) 

mount and dismount file mount(lm) 

mount or remove file mount (2) 

mount or remove file umount{2) 

mounted file system table mtab(5) 

move or rename files and mv(l) 

move read/write pointer lseek(2) 

move read/write pointer tell(2) 

moving-head disk hk(4) 

moving-head disk rp(4) 

multiple precision mp(3x) 

my mail from? from(l) 

riame getenvO) 

r^ame getloginO) 

r^ame mktempO) 

"ame pvd ( 1 ) 

name tty(l) 

name from UID getpw(3) 

name list nlistO) 
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print name list nm(l) 

find name of a terminal ttynameO) 

get/set name of current host ghostname(2) 

set or print name of current host hostname(l) 

conventional names terminals(7) 

generate names from i-n\ambers ncheck(lm) 

print the names of files on a dump diampdir(lm) 

create a new file creat(2) 

convert archives to new format arcv{lm) 

log in to a new group newgrp(l) 

spawn new process fork ( 2 ) 

summary of the 'new' tty driver newtty(4) 

non-local goto setjmpO) 

format tables for nroff or troff tbKl) 

remove nroff, troff, tbl and eqn. . . .derof f (1) 

remote host phone number data Isase phones(5) 

provide drill in number facts arithmetic(6) 

factor a number, generate large factor(l) 

random number generator randO) 

convert ASCII to numbers atof(3) 

to system calls and error numbers errno(2) 

to system calls and error numbers intro(2) 

size of an object file size(l) 

ordering relation for an object library lorder(l) 

/printable strings in a object, or other binary,/. .. .strings(l) 

octal dump odd) 

or subsequent lines of one file paste(l) 

a one way hashing crypt ( 3 ) 

open a stream fopenOs) 

duplicate an open file descriptor.. dup(2) 

duplicate an open file descriptor..' dup2(2) 

open for reading or.... open(2) 

terminal independent operation routines termlibO) 

string operations stringO) 

relational database operator join(l) 

oppress running processes. .. .renice(l) 

copy file systems for optimal access time dcopy(lm) 

screen functions with "optimal" cursor motion cursesO) 

load optional software on osload(lm) 

set terminal options stty(l) 

find ordering relation for an lorder(l) 

orderly system shutdown shutdown(8) 

screen oriented (visual) display. .. .vi(l) 

call UNIX (original V7 version) cu_v7(lc) 

assembler and link editor output a.out(5) 

output conver s ion ecvt ( 3 ) 

formatted output conversion printf(3s) 

process to manage its own stack nostk(2) 

change owner and group chog(l) 

change owner and group of a f ile. . . .chown(2) 

change owner or group chown ( 1 ) 

sxommarize file system ownership quot(lm) 

packet driver pk(4) 

packet driver simulator pkopen(3) 
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set 
report 



line printer 

on MSCP disk 

read a 

change login 



search a 



get 
file for a 



file 
remote host 



allow a process to access 

get floating 

the status of floating 

the status of floating 

move read/write 

move read/write 

make long 

exponential, logarithm, 

multiple 



undo a 

lock a process in 

a number, generate large 

catenate and 



set or 



find the 
line 

line 

set line 

line 

run a command at low 



paginator for the tk(i; 

parameters Ipset ( Im) 

partition sizes rasize(lm) 

password getpass ( 3 ) 

password passwd(l) 

password file passwd(5) 

password file entry getpwent(3) 

pattern grep(l) 

pattern scanning and awk(l) 

permit or deny messages mesg(l) 

permuted index ptx(l) 

perusal filter for crt mored) 

phone number data base phones(5) 

phototypesetter interface. . . .cat(4) 
phototypesetter simulator. . . .tc(l) 

physical addresses phys(2) 

pipe fitting tee(l) 

point error status fperr(2) 

point simulation fpsim(lm) 

point simulation fpsim(2) 

Poiriter lseek( 2) 

pointer tell(2) 

posters banner(6) 

power , square root exp ( 3x ) 

precision integer mp(3x) 

prepare execution profile monitor(3) 

prepare text for prep(l) 

previous get of an unget(l) 

pr imary memory lock ( 2 ) 

primes factor(l) 

primitive system data types(5) 

Pr"int cat(l) 

print I/O buffer usage bufstat(lm) 

print an SCCS prs{l) 

print and set the date date(l) 

print calendar cal(l) 

print current sact { 1 ) 

print effective current whoami(l) 

print file pr(l) 

print memory usage map memstat(lm) 

print name list nm(l) 

print name of current hostname(l) 

print out the environment ... .printenv{l) 

print sections of this man(l) 

print system facts pstat(lm) 

print the names of files dumpdi'r(lm) 

printable strings in a .strings(l) 

pr-inter ip(4) 

printer capability data printcap(5) 

printer daemon lpd(8) 

printer parameters Ipset (Im) 

printer spooler Ipr(l) 

print/modify contents of ipatch(lm) 

priority niced) 
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set program priority nice(2) 

set program priority renice(2) 

startup procedures boot ( 8 ) 

terminate process exit (2) 

spawn new process f ork ( 2 ) 

send signal to a process kill(2) 

initiate I/O to/from a process popenOs) 

await completion of process wait(l) 

process control init(8) 

process control rc(8) 

signal to a process or a process group killpg(2j) 

set/get process group setpgrp(2j) 

get process identification getpid(2) 

get process identification getppid(2) 

lock a process in primary memory. ... lock( 2) 

send signal to a process or a process killpg{2j) 

process status ps( 1) 

get process t imes t imes ( 2 ) 

allow a process to access phys(2) 

allow process to manage its own. . . .nostk(2) 

wait for process to terminate wait2(2) 

wait for process to terminate wait(2j) 

process trace ptrace(2) 

terminate a process with extreme kill(l) 

oppress running processes renice(l) 

text for statistical processing prep(l) 

pattern scanning and processing language awk(l) 

macro processor m4 (1) 

prepare execution profile monitorO) 

execution time profile prof il(2) 

display profile data prof (1) 

last locations in program end(3) 

user information lookup program finger(l) 

conversion program units(l) 

C program beautifier cb{l) 

maintain program groups make(l) 

set program priority nice(2) 

set program priority renice(2) 

program verification assertOx) 

a C program verifier lint(l) 

run a program without a zaptty{lm) 

of lexical analysis programs lex(l) 

structure Fortran programs struct (1) 

extract strings from C programs to implement/ xstr(l) 

provide drill in number arithmetic(6) 

provide truth values trued) 

push character back into ungetcOs) 

put a string on a stream putsOs) 

put character or word on putcOs) 

show lineprinter queue Ipq(l) 

jobs from the lineprinter queue lprm{l) 

quicker sort qsort { 3) 

convert archives to random libraries ranlib(l) 

random number generator rand(3) 
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open for 

move 

move 

send and 

send or 

login 

/and insert literature 

select or 

find ordering 

remove symbols and 



mount or 
mount or 



move or 

check and interactive 

report 



incremental file system 

a game of dramatic 

filter 

logarithm, power, square 

change 
independent operation 



oppress 

validate 

create and administer 

delta commentary of an 

combine 

a delta (change) to an 

get a version of an 

print an 

remove a delta from an 

/two versions of an 

undo a previous get of an 

print current 



rational Fortran dialect ratfor(l) 

read a password getpassO) 

read from file read(2) 

reading or writing open{2) 

read/write pointer lseek(2) 

read/write pointer tell(2) 

receive mail mail(l) 

receive mail among users mail(l) 

records utmp( 5 ) 

references in documents refer(l) 

reject lines common to comm(l) 

relation for an object lorder(l) 

relational database join(l) 

relocation bits strip(l) 

reminder service calendar(l) 

remote host description remote(5) 

remote host phone number phones(5) 

remove a delta from an rmdel(l) 

remove directory entry unlink(2) 

remove file system mount (2) 

remove file system umount(2) 

remove nroff, troff, tbl deroff(l) 

remove symbols and strip(l) 

remove (unlink) files rm(l) 

rename files and mv(l) 

repair f sck ( Im) 

repeated lines in a file uniq(l) 

report I/O statistics iostat(lm) 

report on MSCP disk rasize(lm) 

report or change the fpsim(lm) 

report or change the fpsim(2) 

report repeated lines in uniq(l) 

reposition a stream fseekOs) 

restore restor(lm) 

reversals reversi(6) 

reverse line feeds col(l) 

reverse lines of a file rev(l) 

J^oot expOx) 

root directory chroot(l) 

rout ines terml ib( 3 ) 

run a command at low nice(l) 

run a program without a zaptty(lm) 

running processes renice(l) 

sees file val(l) 

sees files admin(l) 

sees delta cdc(l) 

sees deltas comb(l) 

sees file delta(l) 

sees file get ( 1 ) 

sees file prs ( 1 ) 

sees file rmdel ( 1 ) 

sees file sccsdif f (1) 

sees file unget ( 1 ) 

sees file editing sact(l) 



identify 

merge 

pattern 



print 
cut out 



typescript of terminal 
map of ASCII character 



print and 



merge same lines of 

C programs to implement 

change default login 

issue a 

a 

orderly system 

stop until 

schedule 

send 

send 

catch or ignore 

/manage 

catch or ignore 

status of floating point 

status of floating point 

packet driver 

phototypesetter 

data 

on MSCP disk partition 
interpolate 
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sees files what(l) 

same lines of several paste(l) 

scanning and processing awk(l) 

schedule signal after alarm(2) 

screen functions with cursesO) 

screen oriented (visual) vi(l) 

search a file for a grep(l) 

sections of this manual man{l) 

select or reject lines comm(l) 

selected fields of each cut{l) 

send and receive mail mail(l) 

send or receive mail mail(l) 

send signal to a process kill(2) 

send signal to a process killpg(2j) 

session script (1) 

set ascii(7) 

set file creation mode umask(2) 

set file t imes ut ime ( 2 ) 

set line printer Ipset(lm) 

set or print name of hostname(l) 

set program priority nice(2) 

set program priority renice(2) 

set terminal modes tset(l) 

set terminal options stty(l) 

set terminal tabs tabs(l) 

set the date date(l) 

set t ime st ime ( 2 ) 

set typewriter mode getty(8) 

set user and group ID setuid(2) 

set/get process group setpgrp(2j) 

several files or/ paste(l) 

shared strings xstr{l) 

shell chsh(l) 

shell command systemO) 

shell (command csh(l) 

show lineprinter queue Ipq(l) 

shutdown shutdown ( 8 ) 

sign on login(l) 

signal pause(2) 

signal after specified alarm(2) 

signal to a process kill(2) 

signal to a process or a killpg(2j) 

signals signal(2) 

signals sigset (3j ) 

signals sigsys(2j ) 

simplify special file csf(lm) 

simulation fpsim(lm) 

simulation fpsim(2) 

simulator pkopen( 3) 

simulator tc(l) 

sink null (4) 

size of an object file size(l) 

sizes rasize(lm) 

smooth curve spl i ne ( Ig ) 
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load optional 

RH11/RH70 - ML 11 

quicker 

topological 

lines common to two 

find lines in a 

file by massaging C 

schedule signal after 

find 



line printer 

logarithm, power, 

process to manage its own 



RH11/RH70 - 


MLll solid 




prepare text for 






report I/O 


get 


floating 


point error 

get file 

process 

get file 

stream 




report or 


change the 




report or 


change the 



file system 

close or flush a 

open a 

reposition a 

character or word from 

get a string from a 

character or word on a 

put a string on a 

assign buffering to a 

character back into input 



get a 
put a 

to implement shared 

extract 

find the printable 



list TTY 

data base 

/lines of several files or 



software on Micro/PDP-11 osload(lm) 

solid state disk ml(4) 

sort qsort(3) 

sort tsort ( 1 ) 

sort or merge files sort(l) 

sorted files comm(l) 

sorted list look{l) 

source mkst r ( 1 ) 

spawn new process fork ( 2 ) 

specified time alarm(2) 

spelling errors spell(l) 

split a file into pieces split{l) 

split into mantissa and frexp(3) 

spooler Ipr(l) 

square root exp{3x) 

stack nostk(2) 

standard buffered stdio(3s) 

startup procedures boot (8) 

state disk ^ ml (4) 

statistical processing prep(l) 

statistics iostat(lm) 

status f perr ( 2 ) 

status f Stat (2) 

status ps(l) 

status Stat ( 2 ) 

status inquiries ferror(3s) 

status of floating point/ fpsim(lm) 

status of floating point/. ... fpsim(2) 

stop until signal pause(2) 

storage consistency check icheck(lm) 

stream fclose( 3s) 

stream f open( 3s) 

stream f seek( 3s) 

stream getc(3s) 

stream gets(3s) 

stream putc(3s) 

stream puts(3s) 

stream setbuf (3s) 

stream ungetc(3s) 

stream editor sed(l) 

stream status inquiries ferror(3s) 

string from a stream gets(3s) 

string on a stream puts(3s) 

string operations string(3) 

strings xstr(l) 

strings from C programs xstr(l) 

strings in a object, or strings(l) 

strip filename affixes basename(l) 

structure Fortran struct (1) 

structure assignments tss(lm) 

subroutines dbm(3x) 

subsequent lines of one/ paste(l) 

substitute user id su(l) 

sum and count blocks in a....sum(l) 
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periodically 



update the 

update the 

update 



remove 

interpreter) with C-like 

copy file 

copy file 

copy file 

file system 

file system 

configuration 

format 

set terminal 

create a 

files on a dump 

manipulate 



mounted 
generate 



names of 



DEC /mag 

remove nroff, troff, 

substitute user id 

find name of a 

without a controlling 







general 






general 






set 






get 






set 


make 


typescript of 






set 


wait 


for 


process to 


wait 


for 


process to 



format 



prepare 



signal after specified 



summarize disk usage du(l) 

summarize file system quot(lm) 

summary of job control introOj) 

summary of the 'new* tty newtty(4) 

super block sync ( Im) 

super block update(8) 

super-block sync ( 2 ) 

suspend execution for an sleep(l) 

suspend execution for sleepO) 

swap bytes swab( 3 ) 

symbols and relocation strip(l) 

syntax csh(l) 

systems for optimal dcopy(lm) 

systems with label labelitd) 

systems with label volcopy(lm) 

table fstab(5) 

table mtab(5) 

tables mkconf dm) 

tables for nroff or trof f . . . . tbl(l) 

tabs tabs ( 1 ) 

tags file ctags(l) 

tape dumpdir(lm) 

tape archive tp(l) 

tape archive format tar (5) 

tape archiver tar(l) 

tape formats tp ( 5 ) 

tbl and eqn constructs deroff(l) 

temporarily su(l) 

terminal ttynameO) 

terminal zaptty(lm) 

terminal capability data termcap(5) 

terminal configuration gettytab(5) 

terminal independent termlibO) 

terminal initialization ttys(5) 

terminal interface tty(4) 

terminal interface tty(4) 

terminal modes tset { 1 ) 

terminal name tty(l) 

terminal options stty(l) 

terminal session script(l) 

terminal tabs tabs(l) 

terminal type data ttytype(5) 

terminate wait2(2) 

terminate wait(2j ) 

terminate a process with kill(l) 

terminate process exit (2) 

test your knowledge quiz{6) 

text roff (1) 

text editor ed(l) 

text editor ex(l) 

text for statistical prep(l) 

text formatting and troff(l) 

tic-tac-toe ttt(6) 

t ime alarm( 2 ) 
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commands at a later 

for optimal access 

get date and 

set 

get date and 

execution 

/convert date and 

get process 

set file 

initiate I/O 

process 



tables for nroff or 

remove nroff, 

provide 

zap the controlling 

summary of the 'new' 

determine file 

terminal 

for extended TTY-37 

primitive system data 

make 
macros to 

text formatting and 

set 
do 

make a 

unix to 
unix to 



remove 



periodically 

print I/O buffer 

summarize disk 

print memory 

write to another 

set 

get 

print effective current 
substitute 

enable 
or receive mail among 



^}^^ at(l) 



time 
time 
time 



time 
time 



dcopydm) 

ftime(2) 

St ime ( 2 ) 

^}^^ time{2) 

t ime a command t ime ( 1 ) 

P^^ofile profil(2) 

to ASCII ctimeO) 

tpes times(2) 

ti"Jfs utime(2) 

to/from a process popenOs) 

topological sort tsort ( 1 ) 

t'^^ce- ptrace(2) 

translate characters tr(l) 
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NAME 

intro - introduction to commands 

DESCRIPTION 

This section describes publicly accessible commands in 
alphabetic order. Certain distinctions of purpose are made 
in the headings: 

(1) Commands of general utility. 

(IC) Commands for communication with other systems. 

(IG) Commands used primarily for graphics and computer-aided 
design. 

(IM) Commands used primarily for system maintenance. 

The word 'local' at the foot of a page means that the com- 
mand is not intended for general distribution. 

SEE ALSO 
DIAGNOSTICS 

Section (6) for computer games. 

How to get started , in the Introduction. 

DIAGNOSTICS 

Upon termination each command returns two bytes of status, 
one supplied by the system giving the cause for termination, 
and (in the case of 'normal' termination) one supplied by 
the program, see wait and exit (2) . The former byte is for 
normal termination, the latter is customarily for success- 
ful execution, nonzero to indicate troubles such as errone- 
ous parameters, bad or inaccessible data, or other inability 
to cope with the task at hand. It is called variously 'exit 
code', 'exit status' or 'return code', and is described only 
where special conventions are involved. 
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NAME 

adb - debugger 

SYNOPSIS 

adb [-w] [ objfil [ corfil ] ] 

DESCRIPTION 

Adb is a general purpose debugging program. It may be used 
to examine files and to provide a controlled environment for 
the execution of UNIX programs. 

Ob j f i 1 is normally an executable program file, preferably 
containing a symbol table; if not then the symbolic features 
of adb cannot be used although the file can still be exam- 
ined. The default for ob j f i 1 is a. out. Corfil is assumed to 
be a core image file produced after executing objfil ; the 
default for corfil is core. 

Requests to adb are read from the standard input and 
responses are to the standard output. If the -w flag is 
present then both objfil and corfil are created if necessary 
and opened for reading and writing so that files can be 
modified using adb. Adb ignores QUIT; INTERRUPT causes 
return to the next adb command. 

In general requests to adb are of the form 

[ address ] [, count ] [ command ] [;] 

If address is present then dot is set to address . Initially 
dot is set to 0. For most commands count specifies how many 
times the command will be executed. The default count is 1. 
Address and count are expressions. 

The interpretation of an address depends on the context it 
is used in. If a subprocess is being debugged then 
addresses are interpreted in the usual way in the address 
space of the subprocess. For further details of address 
mapping see ADDRESSES. 



EXPRESSIONS 



The value of dot. 

The value of dot incremented by the current incre- 
ment. 

The value of dot decremented by the current incre- 
ment. 

The last address typed. 
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integer 

An octal nxomber if integer begins with a 0; a hexade- 
cimal number if preceded by #; otherwise a decimal 
number. 

integer . fraction 

A 32 bit floating point number. 

•cccc' The ASCII value of up to 4 characters. \ may be used 
to escape a ' . 

< name The value of name , which is either a variable name or 
a register name. Adb maintains a number of variables 
(see VARIABLES) named by single letters or digits. 
If name is a register name then the value of the 
register is obtained from the system header in cor- 
fjj.. The register names are rO ... r5 sp pc ps. 

symbol A symbol is a sequence of upper or lower case 
letters, underscores or digits, not starting with a 
digit. The value of the symbol is taken from the 
symbol table in objf il . An initial or ~ will be 
prepended to symbol if needed. ~ 

In C, the 'true name' of an external symbol begins 
with _. It may be necessary to utter this name to 
distinguish it from internal or hidden variables of a 
program. 

routine . name 

The address of the variable name in the specified C 
routine. Both routine and name are symbols . If name 
is omitted the value is the address of the iiioit 
recently activated C stack frame corresponding to 
routine . 

( exp ) The value of the expression exp . 

Monadic operators 

*exp The contents of the location addressed by exp in cor- 
f il . — 

(iexE The contents of the location addressed by exp in 
objf il . — '^ 

- exp Integer negation. 

~ exp Bitwise complement. 
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Dyadic operators are left associative and are less binding 
than monadic operators. 

el+e2 Integer addition. 

el-e2 Integer subtraction. 

el*e2 Integer multiplication. 

el%e2 Integer division. 

el&e2 Bitwise conjunction. 

el|e2 Bitwise disjunction. 

el#e2 El rounded up to the next multiple of e2. 

COMMANDS 

Most commands consist of a verb followed by a modifier or 
list of modifiers. The following verbs are available. (The 
commands '?' and '/' may be followed by '*'; see ADDRESSES 
for further details.) 



?f 



/f 



Locations starting at address in objf il are printed 
according to the format f^. 



Locations starting at address 
according to the format f^. 



in corf il are printed 



=f The value of address itself is printed in the styles 
indicated by the format f. (For i format '?' is 
printed for the parts of the instruction that reference 
subsequent words.) 

A format consists of one or more characters that specify a 
style of printing. Each format character may be preceded by 
a decimal integer that is a repeat count for the format 
character. While stepping through a format dot is incre- 
mented temporarily by the amount given for each format 
letter. If no format is given then the last format is used. 
The format letters available are as follows. 



o 2 Print 2 bytes in octal. All octal numbers 

by adb are preceded by . 

4 Print 4 bytes in octal, 

q 2 Print in signed octal. 

Q 4 Print long signed octal, 

d 2 Print in decimal. 

D 4 Print long decimal. 

X 2 Print 2 bytes in hexadecimal. 

X 4 Print 4 bytes in hexadecimal, 

u 2 Print as an unsigned decimal number. 



output 



ADBd) ADB(l) 



U 4 Print long unsigned decimal. 

f 4 Print the 32 bit value as a floating point number. 

F 8 Print double floating point. 

b 1 Print the addressed byte in octal. 

c 1 Print the addressed character. 

C 1 Print the addressed character using the following 
escape convention. Character values 000 to 040 
are printed as @ followed by the corresponding 
character in the range 0100 to 0140. The charac- 
ter @ is printed as 00. 

s n Print the addressed characters until a zero char- 
acter is reached. 

S n Print a string using the @ escape convention. n 
is the length of the string including its zero 
terminator. 

Y 4 Print 4 bytes in date format (see ctimeO)). 

i n Print as PDPll instructions, n is the number of 
bytes occupied by the instruction. This style of 
printing causes variables 1 and 2 to be set to the 
offset parts of the source and destination respec- 
tively. 

a Print the value of dot in symbolic form. Symbols 
are checked to ensure that they have an appropri- 
ate type as indicated below. 



/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 



p 2 Print the addressed value in symbolic form using 
the same rules for symbol lookup as a. 

t When preceded by an integer tabs to the next 
appropriate tab stop. For example, 8t moves to 
the next 8-space tab stop. 

r Print a space. 

n Print a newline. 

• • • \J 

Print the enclosed string. 

Dot is decremented by the current increment. 
Nothing is printed. 
+ Dot is incremented by 1. Nothing is printed. 
Dot is decremented by 1. Nothing is printed. 

newline 

If the previous command temporarily incremented dot, 
make the increment permanent. Repeat the previous com- 
mand with a count of 1. 

[?/]l value mask 

Words starting at dot are masked with mask and compared 
with value until a match is found. If L is used then 
the match is for 4 bytes at a time instead of 2. If no 
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match is found then dot is unchanged; otherwise dot is 
set to the matched location. If mask is omitted then 
-1 is used. 

[?/]w value . . . 

Write the 2-byte value into the addressed location. If 
the command is W, write 4 bytes. Odd addresses are not 
allowed when writing to the subprocess address space. 

[?/]m bl el fl[?/] 

New values for (bl, el, H.) are recorded. If less than 
three expressions are given then the remaining map 
parameters are left unchanged. If the '?' or '/' is 
followed by '*' then the second segment (b2,e2,f2) of 
the mapping is changed. If the list is terminated by 
'?' or '/' then the file ( objf il or corf il respec- 
tively) is used for subsequent requests. (So that, for 
example, Vm?' will cause '/' to refer to objf il . ) 

>name 

Dot is assigned to the variable or register named. 

& modif ier 

The & modifier allows adb to deal with locations in 
overlay text segments, i.e., type 0430 and 0431 files. 
Locations is overlay text segments must be accessed by 
a symbol name or a symbol name plus an offset. For 
example, to display the contents of location (Ipintr) 
as an instruction would be (lpintr/*i) for a non- 
overlaid file. The command (lpintr/*&i) would be used 
of the symbol is located in an overlay text segment. 

! A shell is called to read the rest of the line follow- 
ing ' ! ' . 

$ modif ier 

Miscellaneous commands. The available modifiers are: 

<f Read commands from the file f and return. 

>f Send output to the file f, which is created if it 

does not exist, 
r Print the general registers and the instruction 

addressed by pc. Dot is set to pc. 
f Print the floating registers in single or double 

length. If the floating point status of ps is set 

to double (0200 bit) then double length is used 

anyway, 
b Print all breakpoints and their associated counts 

and commands, 
a ALGOL 68 stack backtrace. If address is given 

then it is taken to be the address of the current 

frame (instead of r4). If count is given then 
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only the first count frames are printed. 
C stack backtrace. If address is given then it is 
taken as the address of the current frame (instead 
of r5). If C is used then the names and (16 bit) 
values of all automatic and static variables are 
printed for each active function. If count is 
given then only the first count frames are 
printed. 

The names and values of external variables are 
printed. 

Set the page width for output to address (default 
80). 

Set the limit for symbol matches to address 
(default 255). 



w 



o 



All integers input are regarded as octal, 
d Reset integer input as described in EXPRESSIONS, 
q Exit from adb . 

V Print all non zero variables in octal, 
m Print the address map. 



:modif ier 



Manage a subprocess. Available modifiers are: 

be Set breakpoint at address . The breakpoint is exe- 
cuted count -1 times before causing a stop. Each 
time the breakpoint is encountered the command c 
is executed. If this command sets dot to zero 
then the breakpoint causes a stop. 

d Delete breakpoint at address . 

r Run objfil as a subprocess. If address is given 
explicitly then the program is entered at this 
point; otherwise the program is entered at its 
standard entry point. count specifies how many 
breakpoints are to be ignored before stopping. 
Arguments to the subprocess may be supplied on the 
same line as the command. An argument starting 
with < or > causes the standard input or output to 
be established for the command. All signals are 
turned on on entry to the subprocess. 

cs The subprocess is continued with signal s c s, see 
signal (2) . If address is given then the subpro- 
cess is continued at this address. If no signal 
is specified then the signal that caused the sub- 
process to stop is sent. Breakpoint skipping is 
the same as for r. 

ss As for c except that the subprocess is single 
stepped count times. If there is no current sub- 
process then objf il is run as a subprocess as for 
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r. In this case no signal can be sent; the 
remainder of the line is treated as argioments to 
the subprocess. 

k The current subprocess, if any, is terminated. 

VARIABLES 

Adb provides a number of variables. Named variables are set 
TnTtially by adb but are not used subsequently. Numbered 
variables are reserved for communication as follows. 

The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

On entry the following are set from the system header in the 
corf il . If corf il does not appear to be a core file then 
these values are set from objf il . 

b The base address of the data segment. 

d The data segment size. 

e The entry point. 

m The 'magic' number (0405, 0407, 0410 or 0411). 

s The stack segment size. 

t The text segment size. 

ADDRESSES 

The address in a file associated with a written address is 
determined by a mapping associated with that file. Each 



mapping 



is represented by two triples (bl, el, fl) and (b2, 
e2"," f2) and the file address corresponding to a written 
address is calculated as follows. 



bl < _address<el => file address = address + f 1 -bl, otherwise, 

b2 < address < e2 => file address = address + f 2 -b2 , 

otherwise, the requested address is not legal. In some 
cases (e.g. for programs with separated I and D space) the 
two segments for a file may overlap. If a ? or / is fol- 
lowed by an * then only the second triple is used. 

The initial setting of both mappings is suitable for normal 
a. out and core files. If either file is not of the kind 
expected then, for that file, bl is set to 0, el is set to 
the maximum file size and fl is set to 0; in this way the 
whole file can be examined with no address translation. 

So that adb may be used on large files all appropriate 
values are kept as signed 32 bit integers. 
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FILES 

/dev/mem 
/dev/swap 
a. out 
core 

SEE ALSO 

ptrace(2), a.out(5), core(5). Setting up Unix 

DIAGNOSTICS 

'Adb' when there is no current command or format. Comments 
about inaccessible files, syntax errors, abnormal termina- 
tion of commands, etc. Exit status is 0, unless last com- 
mand failed or returned nonzero status. 

RESTRICTIONS 

A breakpoint set at the entry point is not effective on ini- 
tial entry to the program. 

When single stepping, system calls do not count as an exe- 
cuted instruction. 

Local variables whose names are the same as an external 
variable may foul up the accessing of the external. 
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NAME 

admin - create and administer SCCS files 

SYNOPSIS 

admin [-n] [-i[name]] [-rrel] [-t[name]] 

[-fflag[flag-val]] [-df lag[f lag-val] ] , r i r i 
[-alogin] [-elogin] [-mCmrlist]] [-y[comment] ] L-h] [-zj 
files 

DESCRIPTION 

Admin is used to create new SCCS files and change parameters 
of existing ones. Arguments to admin, which may appear in 
any order, consist of keyletter argiiments, which begin with 
-, and named files (note that SCCS file names must begin 
with the characters s.). If a named file doesn't exist, it 
is created, and its parameters are initialized according to 
the specified keyletter arguments. Parameters not initial- 
ized by a keyletter argument are assigned a default value. 
If a named file does exist, parameters corresponding to 
specified keyletter arguments are changed, and other parame- 
ters are left as is. 

If a directory is named, admin behaves as though each file 
in the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does not 
begin with s.) and unreadable files are silently ignored. 
If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an 
SCCS file to be processed. Again, non-SCCS files and 
unreadable files are silently ignored. 

The keyletter arguments are as follows. Each is explained 
as though only one named file is to be processed since the 
effects of the arguments apply independently to each named 
file. 

-n This keyletter indicates that a new SCCS 

file is to be created. 

- i [ name ] The name of a file from which the text 
for a new SCCS file is to be taken. The 
text constitutes the first delta of the 
file (see -r keyletter for delta number- 
ing scheme). If the i keyletter is 
used, but the file name is omitted, the 
text is obtained by reading the standard 
input until an end-of-file is encoun- 
tered. If this keyletter is omitted, 
then the SCCS file is created empty. 
Only one SCCS file may be created by an 
admin command on which the i keyletter 
is supplied. Using a single admin to 
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-rrel 



-t[name] 



-f flaq 



create two or more SCCS files require 

that they be created empty (no -i 

keyletter). Note that the -i keyletter 

implies the -n keyletter. 

The release into which the initial delta 
IS inserted. This keyletter may be used 
only if the -i keyletter is also used. 
If the -r keyletter is not used, the 
initial delta is inserted into release 
1. The level of the initial delta is 
always 1 (by default initial deltas are 
named 1.1). 

The name of a file from which descrip- 
tive text for the SCCS file is to be 
taken. if the -t keyletter is used and 
admin is creating a new SCCS file (the 
-n and/or -i keyletters also used), the 
descriptive text file name must also be 
supplied. In the case of existing SCCS 
files: (1) a -t keyletter without a file 
name causes removal of descriptive text 
(if any) currently in the SCCS file, and 
(2) a -t keyletter with a file name 
causes text (if any) in the named file 
to replace the descriptive text (if any) 
currently in the SCCS file. 



This keyletter specifies a 
possibly, a value for the 
placed in the SCCS file, 
keyletters may be supplied 



admin command line. The 
and their values are: 



flag , and, 

flag , to be 

Several f 

on a single 



allowable flag s 



cceil 



Allows use of the -b keyletter on a 
aetd) command to create branch deltas. 

The highest release (i.e., 'ceiling'), a 
number less than or equal to 9999, which 
may be retrieved by a ^etd) command for 
editing. The default value for an 
unspecified c flag is 9999. 

f floor The lowest release (i.e., 'floor'), a 
number greater than but less than 
9999, which may be retrieved by a qet(l) 
command for editing. The default value 
for an unspecified f flag is 1. 
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d SID The default delta number (SID) to be 
used by a get (1) coiranand. 

i Causes the "No id keywords (ge6)" mes- 
sage issued by get (l) or delta (l) to be 
treated as a fatal error. In the 
absence of this flag, the message is 
only a warning. The message is issued 
if no sees identification keywords (see 
qet (l) ) are found in the text retrieved 
or stored in the SCCS file. 

j Allows concurrent get (l) commands for 
editing on the same SID of an SCCS file. 
This allows multiple concurrent updates 
to the same version of the SCCS file. 

Hist A list of releases to which deltas can 
no longer be made (get -e against one of 
these 'locked' releases fails). The 
list has the following syntax: 

<list> ::= <range> I <list> , <range> 
<range> ::= RELEASE NUMBER I a 

The character a in the list is 
equivalent to specifying all releases 
for the named SCCS file. 

n Causes delta (l) to create a 'null' delta 
in each of those releases (if any) being 
skipped when a delta is made in a new 
release (e.g., in making delta 5.1 after 
delta 2.7, releases 3 and 4 are 
skipped) . These null deltas serve as 
'anchor points' so that branch deltas 
may later be created from them. The 
absence of this flag causes skipped 
releases to be non-existent in the SCCS 
file preventing branch deltas from being 
created from them in the future. 

q text User definable text substituted for all 
occurrences of the %Q% keyword in SCCS 
file text retrieved by get (l) . 

m mod Module name of the SCCS file substituted 
for all occurrences of the %M% keyword 
in SCCS file text retrieved by qet(l). 
If the m flag is not specified, the 
value assigned is the name of the SCCS 
file with the leading s. removed. 
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t type Type of module in the SCCS file substi- 
tuted for all occurrences of %Y% keyword 
in SCCS file text retrieved by get (l) . 



to prompt for Modifica- 



v[pgm3 Causes delta (l) ^ ^_ __. ^^ 

tion Request (MR) numbers as the"reason 
for creating a delta. The optional 
value specifies the name of an MR number 
validity checking program (see 
delta (l)). (If this flag is set when 
creating an SCCS file, the m keyletter 
must also be used even if its value is 
null) . 

-dflac[ Causes removal (deletion) of the speci- 
fied flag from an SCCS file. The -d 
keyletter may be specified only when 
processing existing SCCS files. Several 
-d keyletters may be supplied on a sin- 
gle admin command. See the -f keyletter 
for allowable flag names. 

llist A list of releases to be 'unlocked'. 
See the -f keyletter for a description 
of the 1 flag and the syntax of a list . 

-alogin A login name, or numerical UNIX group 
ID, to be added to the list of users 
which may make deltas (changes) to the 
sees file. A group ID is equivalent to 
specifying all login names common to 
that group ID. Several a keyletters may 
be used on a single admin command line. 
As many login s, or numerical group IDs, 
as desired may be on the list simultane- 
ously. If the list of users is empty, 
then anyone may add deltas. 

-elogin A login name, or numerical group ID, to 
be erased from the list of users allowed 
to make deltas (changes) to the SCCS 
file. Specifying a group ID is 
equivalent to specifying all login names 
common to that group ID. Several e 
keyletters may be used on a single admi n 
command line. 



-y[ comment] 



The comment text is inserted into the 
SCCS file as a comment for the initial 
delta in a manner identical to that of 
delta (l) . Omission of the -y keyletter 
results in a default comment line being 
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-m[mrlist ] 



YY/MM/DD HH:MM:SS 



inserted in the form; 

date and time created 

by login 

The -y keyletter is valid only if the -i 
and/or -n keyletters are specified 
(i.e., a new SCCS file is being 
created) . 



The list of Modif 
numbers is inse 
as the reason for 
delta in a manner 
The V flag must 
numbers are vali 
a value (the name 
dation program), 
if the V flag is 
tion fails. 



ication Requests (MR) 

rted into the SCCS file 

creating the initial 

identical to delta(l). 

be set and the MR 

dated if the v flag has 
of an MR number vali- 
Diagnostics will occur 

not set or MR valida- 



-h 



-z 



Causes admin to check the structure of 
the SCCS file (see sccsf ile (5)) , and to 
compare a newly computed check-sum (the 
sum of all the characters in the SCCS 
file except those in the first line) 
with the check-sxom that is stored in the 
first line of the SCCS file. Appropri- 
ate error diagnostics are produced. 

This keyletter inhibits writing on the 
file, so that it nullifies the effect of 
any other keyletters supplied, and is, 
therefore, only meaningful when process- 
ing existing files. 



The SCCS file 
and stored in 
file (see -h. 



check-sum is 
the first line 
above ) . 



recomputed 
of the SCCS 



Note that use of this keyletter on a 
truly corrupted file may prevent future 
detection of the corruption. 



FILES 



The last component 
form s. file-name. 
chmod(l)T 



of all SCCS 
New SCCS 
permission in 



Write 

of course, required to create 
admin is to a temporary x-file 
get (l) ) , created with mode 
creating a new SCCS file, or wi 
file if it exists. After succe 
SCCS file is removed (if it e 



file names must be of the 

files are given mode 444 (see 

the pertinent directory is, 

a file. All writing done by 

called x. file - name , (see 

444 if the admin command is 

th the same mode as the SCCS 

ssful execution of admin, the 

xists), and the x-file is 
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renamed with the name of the SCCS file. This ensures that 
changes are made to the SCCS file only if no errors 
occurred. 

It is recommended that directories containing SCCS files be 
mode 755 and that SCCS files themselves be mode 444. The 
mode of the directories allows only the owner to modify SCCS 
files contained in the directories. The mode of the SCCS 
files prevents any modification at all except by SCCS com- 
mands . 

If it should be necessary to patch an SCCS file for any rea- 
son, the mode may be changed to 644 by the owner allowing 
use of ed(l). Care must be taken ! The edited file should 
always be processed by an admin -h to check for corruption 
followed by an admin -z to generate a proper check-s\am. 
Another admin -h is recommended to ensure the SCCS file is 
valid. 

Admin also makes use of a transient lock file (called 
z. file - name ) , which is used to prevent simultaneous updates 
to the SCCS file by different users. See get (l) for further 
information. 

SEE ALSO 

delta(l) ed(l), get(l), help(l), prs(l), what(l), 
sccsf ile(5) . 

Source Code Control System User 's Guide by L. E. Bonanni and 
C. A. Salemi. 

DIAGNOSTICS 

Use help (l) for explanations. 
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NAME 



ar - archive and library maintainer 



SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive 
fTle. Its main use is to create and update library files as 
used by the loader. It can be used, though, for any similar 
purpose. 

Key is one character from the set drqtpmx, optionally con- 
catenated with one or more of vuaibcl. Afile is the archive 
file. The names are constituent files in the archive file. 
The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the 
optional character u is used with r, then only those 
files with modified dates later than the archive files 
are replaced. If an optional positioning character 
from the set abi is used, then the posname argument 
must be present and specifies that new files are to be 
placed after (a) or before (b or i) posname . Otherwise 
new files are placed at the end. 

q Quickly append the named files to the end of the 
archive file. Optional positioning characters are 
invalid. The command does not check whether the added 
members are already in the archive. Useful only to 
avoid quadratic behavior when creating a large archive 
piece-by-piece. 



Print a table of contents of 
names are given, all files 
If names' are given, only 



the archive file. If no 
in the archive are tabled, 
those files are tabled. 



P 
m 



Print the named files in the archive. 

Move the named files to the end of the archive. If a 
positioning character is present, then the posname 
argument must be present and, as in r, specifies where 
the files are to be moved. 

Extract the named files. If no names are given, all 
files in the archive are extracted. In neither case 
does X alter the archive file. 

Verbose. Under the verbose option, ar gives a file- 
by-file description of the making of a new archive file 
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from the old archive and the constituent files. When 
used with t, it gives a long listing of all information 
about the files. When used with p, it precedes each 
file with a name. 

c Create. Normally ar will create afile when it needs 
to. The create option suppresses the normal message 
that is produced when afile is created. 

1 Local. Normally ar places its temporary files in the 
directory /tmp. This option causes them to be placed 
in the local directory. 

FILES 

/tmp/v* temporaries 

SEE ALSO 

ld(l), ar(5), lorder(l) 

RESTRICTIONS 

If the same file is mentioned twice in an argument list, it 
may be put in the archive twice. 
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NAME 



arcv - convert archives to new format 



SYNOPSIS 
arcv 



file 



DESCRIPTION 

Arcv converts archive files (see ar(l), ar{5)) from 6th edi- 
tion to 7th edition format. The conversion is done in 
place, and the command refuses to alter a file not in old 
archive format. 



Old archives are marked with a magic number 
the start; new archives have 0177545. 



of 0177555 at 



FILES 



/tmp/v*, temporary copy 



SEE ALSO 

ar(l), ar(5) 
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NAME 

as - assembler 

SYNOPSIS 

as [ - ] [ -V ] [ -o objfile ] file ... 

DESCRIPTION 

As assembles the concatenation of the named files. If the 
optional first argument - is used, all undefined symbols in 
the assembly are treated as global. If the optional -V 
argument is used, references to global text symbols are not 
resolved, but left for the loader to resolve. This should 
be done for files that are to be placed in overlays. It does 
not hurt to use the -V flag as long as the output is run 
through the loader, but failure to use it for modules that 
go into overlays can cause improper text references. 

The output of the assembly is left on the file objfile ; if 
that is omitted, a. out is used. It is executable if no 
errors occurred during the assembly, and if there were no 
unresolved external references. 

FILES 

/lib/as2 pass 2 of the assembler 
/tmp/atm[l-3]? temporary 
a. out object 

SEE ALSO 

ld(l), nm(l), adb(l), a.out(5) 

UNIX Assembler Manual by D. M. Ritchie 

DIAGNOSTICS 

When an input file cannot be read, its name followed by a 
question mark is typed and assembly ceases. When syntactic 
or semantic errors occur, a single-character diagnostic is 
typed out together with the line number and the file name in 
which it occurred. Errors in pass 1 cause cancellation of 
pass 2. The possible errors are: 

) Parentheses error 

] Parentheses error 

< String not terminated properly 

* Indirection used illegally 

Illegal assignment to '.' 

a Error in address 

b Branch instruction is odd or too remote 

e Error in expression 

f Error in local ('f or 'b') type symbol 

g Garbage (unknown) character 

i End of file inside an if 

m Multiply defined symbol as label 

o Word quantity assembled at odd address 
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p • . ' different in pass 1 and 2 

r Relocation error 

u Undefined symbol 

X Syntax error 

RESTRICTIONS 

Syntax errors can cause incorrect line nxjunbers in following 
diagnostics. 
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NAME 

at - execute conunands at a later time 

SYNOPSIS 

at time [ day ] [ file ] 

DESCRIPTION 

At squirrels away a copy of the named file (standard input 
default) to be used as input to sh(l) at a specified later 
time. A cd(l) command to the current directory is inserted 
at the beginning, followed by assignments to all environment 
variables. When the script is run, it uses the user and 
group ID of the creator of the copy file. 

The time is 1 to 4 digits, with an optional following 'A', 
•P', 'N' or 'M' for AM, PM, noon or midnight. One and two 
digit niimbers are taken to be hours, three and four digits 
to be hours and minutes. If no letters follow the digits, a 
24 hour clock time is understood. 

The optional da^ is either (1) a month name followed by a 
day number, or (2) a day of the week; if the word 'week' 
follows invocation is moved seven days further off. Names 
of months and days may be recognizably truncated. Examples 
of legitimate commands are 

at Sam jan 24 
at 1530 fr week 

At programs are executed by periodic execution of the com- 
mand / usr / lib / atrun from cron(8). The granularity of at 
depends upon how often atrun is executed. 

Standard output or error output is lost unless redirected. 

FILES 

/usr/spool/at/yy . ddd . hhhh . uu 

activity to be performed at hour hhhh of year day ddd of 

year ^. uu is a unique number. 

/usr/spool/at/lasttimedone contains hhhh for last hour of 

activity. 

/usr/spool/at/past directory of activities now in progress 

/usr/lib/atrun program that executes activities that are due 

pwd ( 1 ) 
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SEE ALSO 

calendar(l) , cron(8) 

DIAGNOSTICS 

Complains about various syntax errors and times out of 
range. 



RESTRICTIONS 

Due to the granularity of the execution of / usr / lib / atrun , 
there may be bugs in scheduling things almost exactly 24 
hours into the future. 
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NAME 

awk - pattern scanning and processing language 

SYNOPSIS 

awk [ -Fc ] [ prog ] [ file ] ... 

DESCRIPTION 

Awk scans each input file for lines that match any of a set 
of patterns specified in prog . With each pattern in prog 
there can be an associated action that will be performed 
when a line of a file matches the pattern. The set of pat- 
terns may appear literally as prog , or in a file specified 
as -f file . 

Files are read in order; if there are no files, the standard 
input is read. The file name '-' means the standard input. 
Each line is matched against the pattern portion of every 
pattern-action statement; the associated action is performed 
for each matched pattern. 

An input line is made up of fields separated by white space. 
(This default can be changed by using FS, vide infra . ) The 
fields are denoted $1, $2, ... ; $0 refers to the entire 
line. 

A pattern-action statement has the form 
pattern { action } 

A missing { action } means print the line; a missing pattern 
always matches. 

An action is a sequence of statements. A statement can be 
one of the following: 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

{ [ statement ] . . . } 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, newlines or right 
braces. An empty expression-list stands for the whole line. 
Expressions take on string or numeric values as appropriate, 
and are built using the operators +, -, *, /, %, and con- 
catenation (indicated by a blank). The C operators ++, — , 
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+=^ -=, *=, /=, and %= are also available in expressions. 
Variables may be scalars, array elements (denoted x[i]) or 
fields. Variables are initialized to the null string. 
Array subscripts may be any string, not necessarily numeric; 
this allows for a form of associative memory. String con- 
stants are quoted "...". 

The print statement prints its arguments on the standard 
output (or on a file if > f ile is present), separated by the 
current output field separator, and terminated by the output 
record separator. The printf statement formats its expres- 
sion list according to the format (see printf (3) ) . 

The built-in function length returns the length of its argu- 
ment taken as a string, or of the whole line if no argument. 
There are also built-in functions exp , log , sqrt , and int . 
The last truncates its argument to an integer. 
substr (s, m, n) returns the n-character substring of s that 
begins at position m. The function 
sprintf ( fmt , expr , expr , ...) formats the expressions 
according to the printf (3) format given by fmt and returns 
the resulting string. 

Patterns are arbitrary Boolean combinations (!, II, &&, and 
parentheses) of regular expressions and relational expres- 
sions. Regular expressions must be surrounded by slashes 
and are as in egrep . Isolated regular expressions in a pat- 
tern apply to the entire line. Regular expressions may also 
occur in relational expressions. 

A pattern may consist of two patterns separated by a comma; 
in this case, the action is performed for all lines between 
an occurrence of the first pattern and the next occurrence 
of the second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, 
and a matchop is either ~ (for contains) or !~ (for does not 
contain). A conditional is an arithmetic expression, a 
relational expression, or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture 
control before the first input line is read and after the 
last. BEGIN must be the first pattern, END the last. 
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A single character c may be used to separate the fields by 
starting the program with 

BEGIN { FS = "c" } 

or by using the -Fc option. 

Other variable names with special meanings include NF, the 
number of fields in the current record; NR, the ordinal 
number of the current record; FILENAME, the name of the 
current input file; OFS, the output field separator (default 
blank); ORS, the output record separator (default newline); 
and OFMT, the output format for numbers (default "%.6g"). 

EXAMPLES 

Print lines longer than 72 characters: 

length > 72 
Print first two fields in opposite order: 

{ print $2, $1 } 
Add up first column, print siim and average: 

{ s += $1 } 
END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; — i) print $i } 
Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous 
one: 

$1 != prev { print; prev = $1 } 

SEE ALSO 

lex(l), sed(l) 

A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk - a pat- 
tern scanning and processing language 

RESTRICTIONS 

There are no explicit conversions between numbers and 
strings. To force an expression to be treated as a niunber 
add to it; to force it to be treated as a string concaten- 
ate "" to it. 
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NAME 

bas - basic 

SYNOPSIS 

bas [ file ] 

DESCRIPTION 

Bas is a dialect of Basic. If a file argument is provided, 
the file is used for input before the terminal is read. Bas 
accepts lines of the form: 

statement 
integer statement 

Integer numbered statements (known as internal statements) 
are stored for later execution. They are stored in sorted 
ascending order. Non-numbered statements are immediately 
executed. The result of an immediate expression statement 
(that does not have '=' as its highest operator) is printed. 
Interrupts suspend computation. 

Statements have the following syntax: 

expression . r^ <. 

The expression is executed for its side ettects 

(assignment or function call) or for printing as 
described above. 

comment ... • 4. • v 

This statement is ignored. It is used to interject 

commentary in a program. 
Return to system level. 

The name and current value of every variable is 
printed. 



done 



dump 



edit 



curre 


snt 


ed, is 
' exits. 



The UNIX editor, ed, is invoked with the file argument, 
After the editor exits, this file is recompiled. 



for name = expression expression statement 
for name = expression expression 

• • ■ 

next ^ ^ . 

The for statement repetitively executes a statement 
(first" form) or a group of statements (second form) 
under control of a named variable. The variable takes 
on the value of the first expression, then is incre- 
mented by one on each loop, not to exceed the value of 
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the second expression. 

goto expression 

The expression is evaluated, truncated to an integer 
and execution goes to the corresponding integer num- 
bered statement. If executed from immediate mode, the 
internal statements are compiled first. 

if expression statement 
if expression 



[ else 
fi 



] 



u!ronf T"S ^•''■^^ ^^^'"^ °^ Sroup Of Statements 
(second form) is executed if the expression evaluates 

^?iowr^r°- ^"^ ^^^ ^^^°"^ f°^"^' ^" optional else 
fi: T^ f""" ^ ?'*°''P °^ statements to be executed when 
the first group is not. 

list [expression [expression]] 

is used to print out the stored internal statements. 
irin^L ^^V^^"^^ ^""^ ^'''®''' ^^^ internal statements are 
St^?«mf;^ • °"?.^f9¥^ent is given, only that internal 
statement is listed. If two arguments are given, all 
aJe^pHited!^^""^"^^ inclusively between the argui^ents 

print list 

Inl irfn.^H ^^PJ^^f i?"s ?"d strings are concatenated 
and printed. (A string is delimited by 



prompt list 

Prompt is 
character 



the same as 
is printed. 



characters. ) 



PJ^i"t except that no newline 



return [expression] 

The expression is evaluated and the result is passed 

back as the value of a function call. if no expression 

IS given, zero is returned. 



run 



The 

is 

reset. 

nal statement. 



internal statements are compiled. The symbol table 

re-initialized. The random number generator is 

Control IS passed to the lowest numbered inter- 



save [expression [expression]] 

Save is like list except that the output 
the file argument. If no argument is 
mand, b.out is used. 



is written on 
given on the com- 
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Expressions have the following syntax: 

name 

A name is used to specify a variable. Names are com- 
posed of a letter followed by letters and digits. The 
first four characters of a name are significant. 

nximber 

A number is used to represent a constant value. a 
number is written in Fortran style, and contains 
digits, an optional decimal point, and possibly a scale 
factor consisting of an e followed by a possibly signed 
exponent. 

( expression ) 

Parentheses are used to alter normal order of evalua- 
tion. 

_ expression 

The result is the negation of the expression. 

expression operator expression 

Common functions of two arguments are abbreviated by 
the two arguments separated by an operator denoting the 
function. A complete list of operators is given below. 

expression ( [expression [ , expression] ... ] ) 

Functions of an arbitrary number of arguments can be 
called by an expression followed by the arguments in 
parentheses separated by commas. The expression evalu- 
ates to the line number of the entry of the function in 
the internally stored statements. This causes the 
internal statements to be compiled. If the expression 
evaluates negative, a builtin function is called. The 
list of builtin functions appears below. 

name [ expression [ , expression ] ... ] 

Each expression is truncated to an integer and used as 
a specifier for the name. The result is syntactically 
identical to a name. a[l,2] is the same as a[l][2]. 
The truncated expressions are restricted to values 
between and 32767. 

The following is the list of operators: 

= is the assignment operator. The left operand must be 
a name or an array element. The result is the right 
operand. Assignment binds right to left, 

& 1 & (logical and) has result zero if either of its argu- 
ments are zero. It has result one if both its argu- 
ments are non-zero. I (logical or) has result zero if 
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^?^J °f^ its argioments are zero. It has result one if 
either of its arguments are non-zero. 

<<=>>= == <> 

The relational operators (< less than, <= less than or 
equal, > greater than, >= greater than or equal, == 
equal to, <> not equal to) return one if their arqu- 
ments are m the specified relation. They return zero 
otherwise. Relational operators at the same level 
extend as follows: a>b>c is the same as a>b&b>c. 

+ - Add and subtract. 

* / Multiply and divide. 

^ Exponentiation. 

The following is a list of builtin functions: 

^"■^^'^ i,^^^^^?^^^ ^^tj® i :th actual parameter on the 
current level of function call. 

exp(x) is the exponential function of x. 

log(x) is the natural logarithm of x. 

sqr(x) is the square root of x. 

sin(x) is the sine of x (radians). 

cos(x) is the cosine of x (radians). 

atn(x) is the arctangent of x. Its value is between -j/2 
and J/2. 

rnd( ) is a uniformly distributed random number between zero 
and one. 

expr( ) 

is the only form of program input. A line is read 
from the input and evaluated as an expression. The 
resultant value is returned. 

abs(x) is the absolute value of x. 

int(x) returns x truncated (towards 0) to an integer. 

FILES 

/tmp/btm? temporary 
b.out save file 
/bin/ed for edit 
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DIAGNOSTICS 

Syntax errors cause the incorrect line to be typed with an 
underscore where the parse failed. All other diagnostics 
are self explanatory. 

RESTRICTIONS 

Has been known to give core images. 

Catches interrupts even when they are turned off. 
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NAME 

basename - strip filename affixes 

SYNOPSIS 

basename string [ suffix ] 

DESCRIPTION 

Basename deletes any prefix ending in '/' and the suffix , if 
present in string , from string , and prints the result on the 
standard output. It is normally used inside substitution 
marks in shell procedures. 

This shell procedure invoked with the argument 
/ usr / src / cmd /cat . c compiles the named file and moves the 
output to cat in the current directory: 



cc $1 

mv a. out 'basename $1 .c 



SEE ALSO 
sh(l) 
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NAME 



be - arbitrary-precision arithmetic language 



SYNOPSIS 

be [ -c ] [ -1 ] [ file ... ] 

DESCRIPTION 

Be is an interactive processor for a language which resem- 
bles C but provides unlimited precision arithmetic. It 
takes input from any files given, then reads the standard 
input. The -1 argument stands for the name of an arbitrary 
precision math library. The syntax for be programs is as 
follows; L means letter a-z, E means expression, S means 
statement. 

Comments 

are enclosed in /* and */. 



Names 



simple variables: L 

array elements: L [ E ] 

The words 'ibase', 'obase', and 'scale' 



Other operands 

arbitrarily long numbers with optional sign and 

decimal point. 

( E ) 

sqrt ( E ) 

length ( E ) number of significant decimal digits 

scale ( E ) number of digits right of decimal point 

L(E, ... ,E) 

Operators 

+ - * / % '^ (% is remainder; ^ is power) 

++ — (prefix and postfix; apply to names) 

==<=>= != < > 

= =+ =- =* =/ =% ='- 



Statements 
E 

tS; ... ; Si 
if ( E ) S 
while ( E ) S 
for ( E ; E ; E ) S 
null statement 
break 
quit 

Function definitions 

define L ( L , . . . , L ) { 
auto L, ... , L 
s ; ... o 
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return { E ) 
} 

Functions in -1 math library 
s(x) sine 
c(x) cosine 
e(x) exponential 
Kx) log 
a(x) arctangent 
j(n,x) Bessel function 

All function arguments are passed by value. 

The value of a statement that is an expression is printed 
unless the main operator is an assignment. Either semi- 
colons or newlines may separate statements. Assignment to 
scale influences the number of digits to be retained on 
arithmetic operations in the manner of dc(l). Assignments 
^° ^^^^^ or obase set the input and output number radix 
respectively. 

The same letter may be used as an array, a function, and a 
simple variable simultaneously. All variables are global to 
the program. 'Auto' variables are pushed down during func- 
tion calls. When using arrays as function arguments or 
defining them as automatic variables empty square brackets 
must follow the array name. 



For 


example 










sea 
def 


le = 20 
ine e{x){ 












auto a, : 


b, c, 


i 


f s 






a = 1 












b = 1 












s = 1 












for(i=l; 


1==1 


« 

• r 


i++){ 






a = 


a*x 










b = 


b*i 










c = 


a/b 










if(( 


c == 


0) 


return(s) 




s = 


s+c 









} 

defines a function to compute an approximate value of the 
exponential function and 

for(i=l; i<=10; i++) e(i) 

prints approximate values of the exponential function of the 
first ten integers. 
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Be is actually a preprocessor for dc(l), which it invokes 
automatically, unless the -c (compile only) option is 
present. In this case the dc input is sent to the standard 
output instead. 

FILES 

/usr/lib/lib.b mathematical library 
dc(l) desk calculator proper 

SEE ALSO 
dc(l) 

L. L. Cherry and R. Morris, BC - An arbitrary precision 
desk - calculator language 

RESTRICTIONS 

No &&, II, or ! operators. 

For statement must have all three E's. 

Quit is interpreted when read, not when executed. 
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NAME 

bdiff - big diff 

SYNOPSIS 

bdiff filel file2 [n] [-s] 

DESCRIPTION 

Bdiff is used in a manner analogous to diff (1) to find which 
lines must be changed in two files to bring them into agree- 
ment. Its purpose is to allow processing of files which are 
too large for diff , Bdiff ignores lines common to the 
beginning of both files, splits the remainder of each file 
into n-line segments, and invokes diff upon corresponding 
segments. The value of n is 3500 by default. If the 
optional third argument is given, and it is numeric, it is 
used as the value for n. This is useful in those cases in 
which 3500-line segments are too large for diff, causing it 
to fail. If filel ( file2 ) is -, the standardTnput is read. 
The optional -s (silent) argument specifies that no diagnos- 
tics are to be printed by bdiff (note, however, that this 
does not suppress possible exclamations by diff . if both 
optional arguments are specified, they must appear in the 
order indicated above. 

The output of bdiff is exactly that of diff , with line 
numbers adjusted to account for the segmenting of the files 
(that is, to make it look as if the files had been processed 
whole). Note that because of the segmenting of the files, 
b<^iff does not necessarily find a smallest sufficient set of 
file differences. 

FILES 

/tmp/bd????? 

SEE ALSO 

diff(l). 

DIAGNOSTICS 

Use help (l) for explanations. 
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NAME 



bufstat - print I/O buffer usage 



SYNOPSIS ^ ^ , . 

bufstat [ ifn ] [ interval ] [ corefile J [ namelist J 

DESCRIPTION 

The bufstat printout shows the current usage of the system s 
I/O buffer cache. The optional argument 'i' specifies that 
the printout should be repeated every interval seconds. The 
'f option causes corefile to be used as memory instead of 
/dev/mem. The 'n' option declares that the system namelist 
should be obtained from namelist instead of /unix. Single 
or multiple options may be specified. The argxaments inter- 
val, corefile, and namelist must occur in the same order as 
the options [ifn]. 

Information printed by bufstat includes; Physical memory 
address of the buffer, nvimber of I/O operations on the 
buffer since system startup, the byte count and logical 
block number for the last I/O operation on the buffer, the 
error code, the 'name' of the device that owns the buffer, 
and the buffer header flags. Where 'name' is the special 
file name for the device, e.g., hkOO, rlO, etc., or the 
device's major/minor device number, if the special file can- 
not be located. 



FILES 



/unix - default system namelist 
/dev/mem - default system memory 



SEE ALSO 

Refer to the ULTRIX-11 System Management Guide, Section 
9.5.2 for an example of a bufstat printout. 
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NAME 



cal - print calendar 



SYNOPSIS 

cal [ month ] year 

DESCRIPTION 

Cal prints a calendar for the specified year. If a month is 
also specified, a calendar just for that month is printed. 
Year can be between 1 and 9999. The month is a number 
between 1 and 12. The calendar produced is that for Enqland 
and her colonies. 



Try September 1752. 

RESTRICTIONS 

The year is always considered to 

though this is historically naive. 

Beware that 'cal 78' refers to the early Christian era, not 

the 20th century. 



start in January even 
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NAME 

calendar - reminder service 

SYNOPSIS 

calendar [ - ] 

DESCRIPTION 

Calendar consults the file 'calendar' in the current direc- 
tory and prints out lines that contain today's or tomorrow's 
date anywhere in the line. Most reasonable month-day dates 
such as 'Dec. 7,' 'december 7,' '12/7,' etc., are recog- 
nized, but not '7 December' or '7/12'. On weekends 'tomor- 
row' extends through Monday, 

When an argument is present, calendar does its job for every 
user who has a file 'calendar' in his login directory and 
sends him any positive results by mail (l) . Normally this is 
done daily in the wee hours under control of cron (8) . 

FILES 

calendar 

/usr/lib/calendar to figure out today's and tomorrow's dates 

/etc/passwd 

/tmp/cal* 

egrep, sed, mail subprocesses 

SEE ALSO 

at(l), cron(8), maiKl) 

RESTRICTIONS 

Your calendar must be public information for you to get rem- 
inder service. 

Calendar 's extended idea of 'tomorrow' doesn't account for 
holidays. 
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NAME 

cat - catenate and print 

SYNOPSIS 

cat [ -u ] file ... 

DESCRIPTION 

Cat reads each file in sequence and writes it on the stan- 
dard output. Thus 

cat file 

prints the file and 

cat filel file2 >file3 

concatenates the first two files and places the result on 
the third. 

If no file is given, or if the argument '-' is encountered, 
cat reads from the standard input. Output is buffered in 
512-byte blocks unless the standard output is a terminal or 
the -u option is present. 

SEE ALSO 

pr(l), cp(l) 

RESTRICTIONS 

Beware of 'cat a b >a' and 'cat a b >b' , which destroy input 
files before reading them. 
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NAME 

cb - C program beaut ifier 

SYNOPSIS 
cb 

DESCRIPTION 

Cb places a copy of the C program from the standard input on 
the standard output with spacing and indentation that 
displays the structure of the program. 

RESTRICTIONS 
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NAME 



cc, pec - C compiler 



SYNOPSIS 

cc [ option ] ... file ... 

pec [ option ] ... file ... 

DESCRIPTION 

Cc is the UNIX C compiler, 
arguments: 



It accepts several types of 



Arguments whose names end with '.c' are taken to be C source 
programs; they are compiled, and each object program is left 
on the file whose name is that of the source with '.o' sub- 
stituted for '.c'. The '.o' file is normally deleted, how- 
ever, if a single C program is compiled and loaded all at 
one go. 



In 



are 



the same way, arguments whose names end with ' .s' 
taken to be assembly source programs and are assembled, pro- 
ducing a ' .o' file. 



.ng 

The following options are interpreted by cc. 
load-time options. 



See ld(l) for 



-c 



Suppress the loading phase of the compilation, and 
force an object file to be produced even if only one 
program is compiled. 



-f 



■0 
-S 



Arrange for the compiler to produce code which 
counts the number of times each routine is called; 
also, if loading takes place, replace the standard 
startup routine by one which automatically calls 
monitor O) at the start and arranges to write out a 
mon.out file at normal termination of execution of 
the object program. An execution profile can then 
be generated by use of prof (1) . 

In systems without hardware floating-point, use a 
version of the C compiler which handles floating- 
point constants and loads the object program with 
the floating-point interpreter. Do not use if the 
hardware is present. 

Invoke an object-code optimizer. 

Compile the named C programs, and leave the 
assembler-language output on corresponding files 
suffixed ' .s' , 



-P 



Run only the macro preprocessor and place the result 
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for each '.c' file in a corresponding '.i' file and 
has no '#' lines in it. 

-E Run only the macro preprocessor and send the result 
to the standard output. The output is intended for 
compiler debugging; it is unacceptable as input to 
cc . 

-V Create code suitable for use in overlaid programs. 
This is now a default flag. 

-V7 Turn of the -V flag. This is provided only for 
backwards compatibility with older versions of cc , 
and in general should not be used. 

-N Place switch tables into text space. This is useful 
for 430 type programs, since the switch tables then 
go into the overlay with the module, saving valuable 
data space. This option must NOT be used for 
separate instruction and data space programs! 

-o output 

Name the final output file output . If this option 
is used the file 'a. out' will be left undisturbed. 

-D name = def 

-D name Define the name to the preprocessor, as if by 

'#define'. If no definition is given, the name is 

defined as 1. 

-U name Remove any initial definition of name. 

-I dir 'finclude' files whose names do not begin with '/' 
are always sought first in the directory of the file 
argument, then in directories named in -I options, 
then in directories on a standard list. 

-B string 

Find substitute compiler passes in the files named 
string with the suffixes cpp, cO, cl and c2. If 
string is empty, use a standard backup version. 

-t[p012] 

Find only the designated compiler passes in the 
files whose names are constructed by a -B option. 
In the absence of a -B option, the string is taken 
to be Vusr/src/cmd/c/' . 

Other arguments are taken to be either loader option argu- 
ments, or C-compatible object programs, typically produced 
by an earlier cc run, or perhaps libraries of C-compatible 
routines. These programs, together with the results of any 
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given) to 



compilations specified, are loaded (in the order 
produce an executable program with name a. out. 

The major purpose of the 'portable C compiler', pcc, is to 
serve as a model on which to base other compilers. Pcc does 
not support options -f, -E, -B, and -t. It providii, in 
addition to the language of cc, unsigned char type data and 
initialized bit fields. 



FILES 



f ile.c 

f ile.o 

a. out 

/tmp/ctm? 

/lib/cpp 

/lib/c[01] 

/usr/c/oc[012] 

/usr/c/ocpp 

/lib/fc[01] 

/lib/c2 

/lib/crtO.o 

/lib/mcrtO.o 

/lib/fcrtO.o 

/lib/libc.a 

/usr/include 

/tmp/pc* 

/usr/lib/ccom 



input file 

object file 

loaded output 

temporaries for cc 

preprocessor 

compiler for cc 

backup compiler for cc 

backup preprocessor 

floating-point compiler 

optional optimizer 

runtime startoff 

startoff for profiling 

startoff for floating-point interpretation 

standard library, see intro O) 

standard directory for '# include' files 

temporaries for 

compiler for pcc 



SEE ALSO 

B. W. Kernighan and D. M. 
Language , Prentice-Hall, 1978 
D. M. Ritchie, C Reference Manual 
monitorO), prof(l), adb(l), ld(l) 



Ritchie, The C Programming 



DIAGNOSTICS 

The diagnostics produced by C itself are intended to be 
self-explanatory. Occasional messages may be produced by 
the assembler or loader. Of these, the most mystifying are 
from the assembler, as(l), in particular 'm' , which means a 
multiply-defined external symbol (function or data). 

RESTRICTIONS 

Pcc is little tried on the PDPll; specialized code generated 
for that machine has not been well shaken down. The -0 
optimizer was designed to work with cc; its use with pcc is 
suspect. — 
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NAME 

cd - change working directory 

SYNOPSIS 

cd directory 

DESCRIPTION 

Directory becomes the new working directory. The process 
must have execute (search) permission in directory . 

Because a new process is created to execute each command, cd 
would be ineffective if it were written as a normal command. 
It is therefore recognized and executed by the Shell. 

SEE ALSO 

sh(l), pwd(l), chdir(2) 
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NAME 

cda, ccd - crash dump analysis 

SYNOPSIS 

cda -options [namelist] [corefile] 
ccd 

DESCRIPTION 

The ccd command copies a crash dump from a magtape, RX50 
diskette, or the swap area to a file, for analysis by the 
cda program. 

Refer to the ULTRlx-11 System Management Guide, Section 9.5 
for a description of the cda program and Section 9.4 for a 
description of the ccd program. 

SEE ALSO 

ULTRIX-11 System Management Guide, Chapter 9 
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NAME 

cdc - change the delta conmientary of an SCCS delta 

SYNOPSIS 

cdc -rSID [-m[mrlist]] [ -y[ comment ] ] files 

DESCRIPTION 

Cdc changes the delta commentary , for the SID specified by 
the -r key letter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request 
(MR) and comment information normally specified via the 
delta (1) command {-m and -y keyletters). 

If a directory is named, cdc behaves as though each file in 
the directory were specified as a named file, except that 
non-SCCS files {last component of the path name does not 
begin with s.) and unreadable files are silently ignored. 
If a name of - is given, the standard input is read (see 
WARNINGS ) ; each line of the standard input is taken to be 
the name of an SCCS file to be processed. 

Argioments to cdc, which may appear in any order, consist of 
keyletter arguments, and file names. 

All the described keyletter arguments apply independently to 
each named file: 

-rSID Used to specify the SCCS Identification 

( SID ) string of a delta for which the 
delta commentary is to be changed. 

-mC mrlist ] If the SCCS file has the v flag set (see 
admin (l) ) then a list of MR numbers to 
be added and/or deleted in the delta 
commentary of the SID specified by the 
-r keyletter may be supplied. A null MR 
list has no effect. 

MR entries are added to the list of MRs 
in the same manner as that of delta (l) . 
In order to delete an MR, precede the MR 
number with the character I (see EXAM- 
PLES ). If the MR to be deleteS is 
currently in the list of MRs, it is 
removed and changed into a 'comment' 
line. A list of all deleted MRs is 
placed in the comment section of the 
delta commentary and preceded by a com- 
ment line stating that they were 
deleted. 
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If -m is not used and the standard input 
is a terminal, the prompt MRs? is issued 
on the standard output before the stan- 
dard input is read; if the standard 
input is not a terminal, no prompt is 
issued. The MRs? prompt always precedes 
the comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks 
and/or tab characters. An unescaped 
new-line character terminates the MR 
list. 

Note that if the v flag has a value (see 
admin (l) ) , it is taken to be the name of 
a program (or shell procedure) which 
validates the correctness of the MR 
numbers. If a non-zero exit status is 
returned from the MR number validation 
program, cdc terminates and the delta 
commentary remains unchanged. 

-y[ comment ] Arbitrary text used to replace the 
comment (s) already existing for the 
delta specified by the -r keyletter. 
The previous comments are kept and pre- 
ceded by a comment line stating that 
they were changed. A null comment has 
no effect. 

If -y is not specified and the standard 
input is a terminal, the prompt com- 
ments? is issued on the standard output 
before the standard input is read; if 
the standard input is not a terminal, no 
prompt is issued. An unescaped new-line 
character terminates the comment text. 

The exact permissions necessary to modify the SCCS file 
are documented in the Source Code Control System user 's 
Guide . Simply stated, they are either (1) if you made 
the delta, you can change its delta commentary; or (2) 
if you own the file and directory you can modify the 
delta commentary. 

EXAMPLES 

cdc -rl.6 -m"bl78-12345 !bl77-54321 bl79-00001" -ytrou- 
ble s.file 

adds bl78-12345 and bl79-00001 to the MR list, removes 
bl77-54321 from the MR list, and adds the comment trouble to 
delta 1.6 of s.file. 
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cdc -rl.6 s.file 

MRS? «bl77-54321 bl78-12345 bl79-00001 

comments? trouble 

does the same thing. 

WARNINGS 

If sees file names are supplied to the cdc command via the 
standard input (- on the command line), then the -m and -y 
keyletters must also be used. 

FILES 

x-file (see delta (l) ) 
z-file (see delta (l) ) 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 
Source Code Control System User 's Guide by L. E. Bonanni and 
C. A. Salemi. 

DIAGNOSTICS 

Use help (l) for explanations. 
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NAME 

chfn - change finger entry 

SYNOPSIS 

chfn [ loginname ] 

DESCRIPTION 

Chfn is used to change information about users. This infor- 
mation is used by the finger program, among others. It con- 
sists of the user's "real life" name, office room number, 
office phone number, and home phone number. Chfn prompts 
the user for each field. Included in the prompt is a 
default value, which is enclosed between brackets. The 
default value is accepted simply by typing <return>. To 
enter a blank field, type the word 'none'. Below is a sam- 
ple run: 

Name [Biff Studsworth II]: 

Office location []: 521E 

Office Phone (Ex: 1632) []: 1863 

Home Phone (Ex: 987532) [5771546]: none 

Chfn allows phone numbers to be entered with or without 
hyphens . 

It is a good idea to run finger after running chfn to make 
sure everything is the way you want it. 

The optional argument loginname is used to change another 
person's finger information. This can only be done by the 
super-user. 

FILES 

/etc/passwd, /etc/ptmp 

SEE ALSO 

finger(l), passwd(5) 

RESTRICTIONS 

For historical reasons, the user's name, etc. are stored in 
the passwd file. This is a bad place to store the informa- 
tion. 

Because two users may try to write the passwd file at once, 
a synchronization method was developed. On rare occasions, 
a message that the password file is "busy" will be printed. 
In this case, chfn sleeps for a while and then tries to 
write to the passwd file again. 
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NAME 

chghist change the history entry of an SCCS delta 

SYNOPSIS 

chghist -rSID name . . . 

DESCRIPTION 

Chghist changes the history information, for the delta 
specified by the SID, of each named SCCS file. 

If a directory is named, chghist behaves as though each file 
in the directory were specified as a named file, except that 
non-SCCS files (last component of the pathname does not 
begin with 's.'), and unreadable files, are silently 
ignored. If a name of '-' is given, the standard input is 
read; each line of the standard input is taken to be the 
name of an SCCS file to be processed. Again, non-SCCS 
files, and unreadable files, are silently ignored. 

The exact permissions necessary to change the history entry 
of a delta are documented in the SCCS / PWB User 's Manual . 
Simply stated, they are either (1) if you made a delta, you 
can change its history entry; or (2) if you own the file and 
directory you can change a history entry. 

The new history is read from the standard input. If the 
standard input is a terminal, the program will prompt with 
'MRS? ' (only if the file has a v flag, see admin (I)) and 
with 'comments? '. If the standard input is not a terminal, 
no prompt(s) is (are) printed. A newline preceded by a '\' 
is read as a blank, and may be used to make the entering of 
the history more convenient. The first newline not preceded 
by a '\' terminates the response for the corresponding 
prompt . 

When the history entry of a delta table record (see prt (I)) 
is changed, all old MR entries (if any) are converted to 
comments, and both these and the original comments are pre- 
ceded by a comment line that indicates who made the change 
and when it was made. The new information is entered preced- 
ing the old. No other changes are made to the delta table 
entry. 

FILES 

x-file (see delta (1)) z-file (see delta (1)) 

SEE ALSO 

admin(l), get(l), delta(l), prt(l), help(l), sccsfile(5) 
SCCS / PWB User 's Manual by L. E. Bonanni and A. L. Glasser. 

DIAGNOSTICS 

Use help (1) for explanations. 
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NAME 



chmod - change mode 



SYNOPSIS 

chmod mode file ... 

DESCRIPTION 

The mode of each named file is changed according to mode , 
which may be absolute or symbolic. An absolute mode is an 
octal number constructed from the OR of the following modes: 



4000 
2000 
1000 
0400 
0200 
0100 
0070 
0007 



set user ID on execution 

set group ID on execution 

sticky bit, see chmod (2) 

read by owner 

write by owner 

execute (search in directory) by owner 

read, write, execute (search) by group 

read, write, execute (search) by others 



A symbolic mode has the form: 

[who] op permission [ op permission ] ... 

The who part is a combination of the letters u (for user's 
permissions), g (group) and o (other). The letter a stands 
for ugo. If who is omitted, the default is a but the setting 
of the file creation mask (see umask(2)) is taken into 
account. 

Op can be + to add permission to the file's mode, - to take 
away permission and = to assign permission absolutely (all 
other bits will be reset). 



Permission is any combination of the letters r (read), w 
(write) , X (execute), s (set owner or group id) and t (save 
text - sticky). Letters u, g or o indicate that permission 
is to be taken from the current mode. Omitting permission 
is only useful with = to take away all permissions. 



permission to others, the 



The first example denies write 
second makes a file executable: 

chmod o-w file 
chmod +x file 

Multiple symbolic modes separated by commas may be given. 
Operations are performed in the order specified. The letter 
s is only useful with u or g. 

Only the owner of a file (or the super-user) may change its 
mode. 
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SEE ALSO 

ls(l), chmod(2), chown (1), stat(2), umask(2) 
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NAME 

chog - change owner and group 

SYNOPSIS 

chog owner files... 

DESCRIPTION 

Chog changes the user-ID and the group-ID of files to the 
user-ID and default group-ID of owner . The owner may be 
either a login name or a decimal UID, but it must be found 
in the password file. 

Only the super-user is allowed to change owner and qrouo 
ID'S. y P 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

chown(2), chgrp(2), passwd(5), group(5) 
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NAME 

chown, chgrp - change owner or group 

SYNOPSIS 

chown owner file ... 

chgrp group file ... 

DESCRIPTION 

Chown changes the owner of the files to owner. The owner 
may be either a decimal UID or a login name found in the 
password file. 

Chgrp changes the group-ID of the files to group . The group 
may be either a decimal GID or a group name found in the 
group-ID file. 

Only the super-user can change owner or group, in order to 
simplify as yet unimplemented accounting procedures. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

chown(2), passwd(5), group(5) 
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NAME 

chroot - change root directory 

SYNOPSIS 

chroot newdir 

DESCRIPTION 

Chroot changes the root directory to newdir and then execs a 
new shell. The new shell is determined from the environment 
variable SHELL, if it is not set then /bin/sh is used. The 
shell is executed relative to the new directory. The prompt 
is changed to ( subroot )-> to remind the user of his new 
environment. 

Only the super-user can change the root directory. 

FILES 

/bin/sh 

SEE ALSO 

chroot (2) 
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NAME 



chsh - change default login shell 



SYNOPSIS 

chsh name [ shell ] 

DESCRIPTION 

Chsh is a command similar to passwd (l) 
used to change the login shell field 
rather than the password entry. If no 
then the shell reverts to the default 



except that it is 
of the password file 
shell is specified 
login shell / bin /sh. 
specified as 



Currently only / bin / csh or / bin / oldcsh can be 
the shell unless you are the super-user. 

An example use of this command would be 

chsh bill /bin/csh 

This example changes the default shell for the user bill to 
be /bin/csh. 



SEE 



ALSO 
csh(l). 



passwd(l), passwd(5) 
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NAME 

clri - clear i-node 

SYNOPSIS 

clri filesystem i-number 

DESCRIPTION 

Clri writes zeros on the i-nodes with the decimal i-numbers 
on the filesystem. After clri , any blocks in the~affected 
file will show up as 'missing' in an icheck(l) or fsck(l) of 
the filesystem . 

Read and write permission is required on the specified file 
system device. The i-node becomes allocatable. 

The primary purpose of this routine is to remove a file 
which for some reason appears in no directory. if it is 
^u®*^i^°^^^P ^" i-node which does appear in a directory, care 
should be taken to track down the entry and remove it. Oth- 
erwise, when the i-node is reallocated to some new file the 
old entry will still point to that file. At that point 
removing the old entry will destroy the new file. The new 
entry will again point to an unallocated i-node, so the 
whole cycle is likely to be repeated again and again. 

SEE ALSO 

icheck(l), fsck(l), ipatch(l) 

RESTRICTIONS 

If the file is open, clri is likely to be ineffective. 

The clri command should be used only as a last resort, fsck 
provides a much safer method of accomplishing file'sviteiii 
repairs. ^ 
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NAME 

cmp - compare two files 

SYNOPSIS 

cmp [ -1 ] t -s ] filel file2 

DESCRIPTION 

The two files are compared. (If filel is '-', the standard 
input is used. ) Under default options, cmp makes no comment 
if the files are the same; if they differ, it announces the 
byte and line number at which the difference occurred. If 
one file is an initial subsequence of the other, that fact 
is noted. 

Options: 

-1 Print the byte number (decimal) and the differing 
bytes (octal) for each difference. 

-s Print nothing for differing files; return codes only. 

SEE ALSO 

diff(l), comm(l) 

DIAGNOSTICS 

Exit code is returned for identical files, 1 for different 
files, and 2 for an inaccessible or missing argument. 
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NAME 

col - filter reverse line feeds 

SYNOPSIS 

col [-bfx] 

DESCRIPTION 

Col reads the standard input and writes the standard output. 
It performs the line overlays implied by reverse line feeds 
(ESC-7 in ASCII) and by forward and reverse half line feeds 
(ESC-9 and ESC-8). Col is particularly useful for filtering 
multicolumn output made with the '.rt' command of nroff and 
output resulting from use of the tbl(l) preprocessor^ 

Although col accepts half line motions in its input, it nor- 
mally does not emit them on output. Instead, text that 
would appear between lines is moved to the next lower full 
line boundary. This treatment can be suppressed by the -f 
(fine) option; in this case the output from col may contain 
forward half line feeds (ESC-9), but will stTll never con- 
tain either kind of reverse line motion. 

If the -b option is given, col assumes that the output dev- 
ice in use is not capable of backspacing. In this case, if 
several characters are to appear in the same place, only the 
last one read will be taken. 

The control characters SO (ASCII code 017), and SI (016) are 
assumed to start and end text in an alternate character set. 
The character set (primary or alternate) associated with 
each printing character read is remembered; on output, SO 
and SI characters are generated where necessary to maintain 
the correct treatment of each character. 

Col normally converts white space to tabs to shorten print- 
ing time. If the -x option is given, this conversion is 
suppressed. 

All control characters are removed from the input except 
space, backspace, tab, return, newline, ESC (033) followed 
by one of 789, SI, SO, and VT (013). This last character is 
an alternate form of full reverse line feed, for compatibil- 
ity with some other hardware conventions. All other non- 
printing characters are ignored. 

SEE ALSO 

troff(l), tbl(l), greek(l) 

RESTRICTIONS 

Can't back up more than 128 lines. 

No more than 800 characters, including backspaces, on a 

line. 
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NAME 

comb - combine SCCS deltas 

SYNOPSIS 

comb [-o] [-s] [-psid] [-clist] files 

DESCRIPTION 

Comb generates a shell procedure (see shCD) which, when 
run7 will reconstruct the given SCCS files. The recon- 
structed files will, hopefully, be smaller than the original 
files. The arguments may be specified in any order, but all 
keyletter arguments apply to all named SCCS files. If a 
directory is named, comb behaves as though each file in the 
directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin 
with s.) and unreadable files are silently ignored. If a 
name of - is given, the standard input is read; each line of 
the standard input is taken to be the name of an SCCS file 
to be processed; non-SCCS files and unreadable files are 
silently ignored. 

The generated shell procedure is written on the standard 
output . 

The keyletter arguments are as follows. Each is explained 
as though only one named file is to be processed, but the 
effects of any keyletter argument apply independently to 
each named file. 

-p SID The SCCS IDentif ication string (SID) of the oldest 
delta to be preserved. All older deltas are dis- 
carded in the reconstructed file. 

-clist A list (see get (l) for the syntax of a list ) of del- 
tas to be preserved. All other deltas are dis- 
carded. 

-o For each get -e generated, this argument causes the 
reconstructed file to be accessed at the release of 
the delta to be created, otherwise the reconstructed 
file would be accessed at the most recent ancestor. 
Use of the -o keyletter may decrease the size of the 
reconstructed SCCS file. It may also alter the 
shape of the delta tree of the original file. 

-s This argument causes comb to generate a shell pro- 
cedure which, when run, will produce a report giv- 
ing, for each file: the file name, size (in blocks) 
after combining, original size (also in blocks), and 
percentage change computed by: 

100 * (original - combined) / original 
It is recommended that before any SCCS files are 
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actually combined, one should use this option to 
determine exactly how much space is saved by the 
combining process. 

If no keyletter arguments are specified, comb will preserve 
only leaf deltas and the minimal number of ancestors needed 
to preserve the tree. 



FILES 



S . COMB 
comb????? 



The name of 
Temporary. 



the reconstructed SCCS file, 



SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 
Source Code Control System User 's Guide by L. E. Bonanni and 
C. A. Salemi. 



DIAGNOSTICS 

Use help (l) 



for explanations. 



RESTRICTIONS 

Comb may rearrange the shape of the tree of deltas. It may 
not save any space; in fact, it is possible for the recon- 
structed file to actually be larger than the original. 
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NAME 



conun - select or reject lines conunon to two sorted files 



SYNOPSIS 

comm [ - [ 123 ] ] filel file2 



DESCRIPTION 

Conun reads 



filel and 



collating sequence, 
lines only in filel ; 
files. The filename 



f ile2 , which should be ordered in ASCII 
and produces a three column output: 
lines only in f ile2 ; and lines in both 
'-' means the standard input. 



Flags 1, 2, or 3 suppress printing of 
column. Thus comm -12 prints only the 
two files; comm -23 prints only lines in 
not in the second; comm -123 is a no-op. 



the corresponding 
lines common to the 
the first file but 



SEE ALSO 

cmp(l), diff(l), uniq(l) 
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NAME 

cp - copy 

SYNOPSIS 

cp filel file2 

cp file ... directory 

DESCRIPTION 

Filel is copied onto file2 . The mode and owner of f ile2 are 
preserved if it already existed; the mode of the source file 
is used otherwise. 

In the second form, one or more files are copied into the 
directory with their original file-names. 

92 refuses to copy a file onto itself. 

SEE ALSO 

cat(l), pr(l), mv(l) 
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NAME 

cpio - copy file archives in and out 

SYNOPSIS 

cpio -o [ acBv ] 

cpio -i [ BcdmrtuvfsSb6 ] [ patterns ] 

cpio -p [ adlmruv ] directory 

DESCRIPTION 

Cpio -o (copy out) reads the standard input to obtain a list 
of path names and copies those files onto the standard out- 
put together with path name and status information. 

Cpio -i (copy in) extracts files from the standard input 
which is assumed to be the product of a previous cpio -o. 
Only files with names that match patterns are selected. 
Patterns are given in the name-generating notation of sh(l). 
In patterns , meta-characters ?, *, and [...] match the slash 
/ character. Multiple patterns may be specified and if no 
patterns are specified, the default for patterns is * (i.e., 
select all files). The extracted files are conditionally 
created and copied into the current directory tree based 
upon the options described below. 

Cpio -p (pass) reads the standard input to obtain a list of 

path names of files that are conditionally created and 

copied into the destination directory tree based upon the 
options described below. 

The meanings of the available options are: 

a Reset access times of input files after they have been 

copied. 
B Input/output is to be blocked 5,120 bytes to the record 

(does not apply to the pass option; meaningful only 

with data directed to or from /dev/rmt?,/dev/rht?) . 
d Directories are to be created as needed, 
c Write he"ader information in ASCII character form for 

portability, 
r Interactively rename files. If the user types a null 

line, the file is skipped, 
t Print a table of contents of the input. No files are 

created, 
u Copy unconditionally (normally, an older file will not 

replace a newer file with the same name). 
V Verbose ; causes a list of file names to be printed. 

When used with the t option, the table of contents 

looks like the output of an Is -1 command (see ls(l) ) . 
1 Whenever possible, link files rather than copying them. 

Usable only with the -p option. 
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Retain previous file modification time. This option is 
ineffective on directories that are being copied. 

f Copy in all files except those in patterns . 

s Swap bytes. Use only with the -i option. 

5 Swap half words. Use only with the -i option. 

b Swap both bytes and half words. Use only with the -i 
option. 

6 Process an old (i.e., UNIX System Sixth Edition format) 
file. Only useful with -i (copy inT! 

EXAMPLES 

The first example below copies the contents of a directory 
into an archive; the second duplicates a directory hierar- 
chy: 

Is I cpio -o >/dev/htO 

cd olddir 

find . -depth -print I cpio -pdl newdir 

The trivial case "find . -depth -print I cpio -oB 
>/dev/rmtO" can be handled more efficiently by: 

find . -cpio /dev/rmtO 

SEE ALSO 

ar(l), find(l), cpio(5). 

RESTRICTIONS 

Path names are restricted to 128 characters. If there are 
too many unique linked files, the program runs out of memory 
to keep track of them and, thereafter, linking information 
is lost. Only the super-user can copy special files. 
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NAME 

csf, msf - simplify special file creation 

SYNOPSIS 

/etc/csf [-r] [-f #] [-C #] dn# [ tty# ] . . . dn# [ tty# ] 

cd /dev 

msf devtype unit [ tty# ] 

DESCRIPTION 

The csf program creates all of the special files for a dev- 
ice with a single command. The optional '-r' specifies that 
the special files are to be removed instead of created. 

The optional '-f #' argument causes only the special file 
for disk partition # to be created or removed. Multiple 
'-f arguments may not be given. 

The '-C #' argument specifies the MSCP disk controller 
number, zero is assumed if the '-c #' is omitted. 

The dn# argument specifies the device name and unit number. 
The 'dn' is the ULTRIX-11 mnemonic for the device, see the 
ULTRIX-11 System Management Guide, Appendix C for a list of 
device mnemonics. For all devices, except DL and KL, # is 
the unit number. For disks and tapes, if the # is omitted 
the special files for all possible units will be created or 
removed. For all other devices # must be present. For the 
KL and DL devices, # is the number of units present. 

The optional 'tty#' specifies the TTY line nximber associated 
with the first port on the device. This argument must be 
given as shown, i.e., the letters 'tty' followed by the line 
niimber. If the 'tty#' argument is omitted line zero is 
assumed. If both KL and DL devices are present, then their 
special files must be created with a single execution of the 
csf command, for example: 

/etc/csf kl4 ttyl6 dl3 tty20 

This is necessary because the starting minor device number 
for the DL depends on how many KL devices are present. Do 
not create the special file for the console terminal (KLO). 

The msf command is a shell procedure that uses the / etc / csf 
program to create the special files for a device. The 
'devtype' argument is the generic name of the device, i.e., 
rp06, raSO, tul6, Ipll, dzll, etc. The 'devtype' takes the 
form 'devtype_cn' for disks that can be attached to multiple 
controllers, '_cn' is the controller number. For example, 
rp06_l for an RP06 disk on the second RH11/RH70 MASSBUS disk 
controller, or rx50 2 for an RX50 on the third MSCP disk 
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controller. The 'unit' argument is the unit number. The 
'tty#' is identical to the tty# used with the csf program, 
except that is must be present. 



FILES 



/dev/* 



SEE ALSO 

mknod(l) 

ULTRIX-11 System Management Guide, Sections 1.4 and 2.6. 
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NAME 

csh - a shell (command interpreter) with C-like syntax 

SYNOPSIS 

csh [ -cefinstvVxX ] [ arg ... ] 

DESCRIPTION 

Csh is a first implementation of a command language inter- 
preter incorporating a history mechanism (see History Sub- 
stitutions), job control facilities (see Jobs) and a C-like 
syntax. So as to be able to use its job control facilities, 
users of csh must (and automatically do) use the new tty 
driver summarized in newtty (4) and fully described in 
tty (4) . This new tty driver allows generation of interrupt 
characters from the keyboard to tell jobs to stop. See 
stty (l) for details on setting options in the new tty 
driver. Login (l) normally switches to the new line discip- 
line if the shell is specified as / bin / csh ; otherwise it 
sets the terminal stop characters to be undefined. In this 
way, users of / bin / oldcsh may use the same shell without job 
control if that name is a link to / bin / csh . 

An instance of csh begins by executing commands from the 
file ' .cshrc' in the home directory of the invoker. If this 
is a login shell then it also executes commands from the 
file '.login' there. It is typical for users on crt's to 
put the command 'stty crt' in their . login file, and to also 
invoke tset(l) there. 

In the normal case, the shell will then begin reading com- 
mands from the terminal, prompting with '% '. Processing of 
arguments and the use oif the shell to process files contain- 
ing command scripts will be described later. 

The shell then repeatedly performs the following actions: a 
line of command input is read and broken into words . This 
sequence of words is placed on the command history list and 
then parsed. Finally each command in the current line is 
executed. 

When a login shell terminates it executes commands from the 
file '.logout' in the users home directory. 

Lexical structure 



The shell splits input lines into words at blanks and tabs 
with the following exceptions. The characters '&' 'I' ';' 
'<' '>' '(' ')' form separate words. If doubled in '&&', 
'II', '<<' or '>>' these pairs form single words. These 
parser metacharacters may be made part of other words, or 
prevented their special meaning, by preceding them with '\'. 
A newline preceded by a '\' is equivalent to a blank. 
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In^ addition strings enclosed in matched pairs of quotations, 
'''f ' ' or '"', form parts of a word; metacharacters in 
these strings, including blanks and tabs, do not form 
separate words. These quotations have semantics to be 
described subsequently. Within pairs of '*' or '"' charac- 
ters a newline preceded by a '\' gives a true newline char- 
acter. 

When the shell's input is not a terminal, the character '#' 
introduces a comment which continues to the end of the input 
line. It is prevented this special meaning when preceded by 
'\' and in quotations using ' ', '•', and "" . 

Commands 

A simple command is a sequence of words, the first of which 
specifies the command to be executed. A simple command or a 
sequence of simple commands separated by 'I' characters 
forms a pipeline. The output of each command in a pipeline 
is connected to the input of the next. Sequences of pipe- 
lines may be separated by ' ; ' , and are then executed sequen- 
tially. A sequence of pipelines may be executed without 
immediately waiting for it to terminate by following it with 
an • & ' . 

Any of the above may be placed in '{' ')' to form a simple 
command (which may be a component of a pipeline, etc.) It is 
also possible to separate pipelines with 'M' or '&&' indi- 
cating, as in the C language, that the second is to be exe- 
cuted only if the first fails or succeeds respectively. (See 
Expressions . ) 

Jobs 

The shell associates a job with each pipeline. It keeps a 
table of current jobs, printed by the jobs command, and 
assigns them small integer numbers. When a job is started 
asynchronously with '&', the shell prints a line which looks 
like: 

[1] 1234 

indicating that the job which was started asynchronously was 
job number 1 and had one (top-level) process, whose process 
id was 1234. 

If you are running a job and wish to do something else you 
may hit the key '^Z (control-Z) which sends a STOP signal to 
the current job. The shell will then normally indicate that 
the job has been 'Stopped', and print another prompt. You 
can then manipulate the state of this job, putting it in the 
background with the bg command, or run some other commands 
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and then eventually bring the job back into the foreground 
with the foreground command fq. A '-Z takes effect immedi- 
ately and is like an interrupt in that pending output and 
unread input are discarded when it is typed. There is 
another special key ^Y which does not generate a STOP signal 
until a program attempts to read (2) it. This can usefully 
be typed ahead when you have prepared some commands for a 
job which you wish to stop after it has read them. 

A job being run in the background will stop if it tries to 
read from the terminal. Background jobs are normally 
allowed to produce output, but this can be disabled by giv- 
ing the command 'stty tostop' . If you set this tty option, 
then background jobs will stop when they try to produce out- 
put like they do when they try to read input. 

There are several ways to refer to jobs in the shell. The 
character '%' introduces a job name. If you wish to refer 
to job number 1, you can name it as '%!'. Just naming a job 
brings it to the foreground; thus '%!' is a synonym for ' f g 
%1', bringing job 1 back into the foreground. Similarly 
saying '%1 &' resumes job 1 in the background. Jobs can 
also be named by prefixes of the string typed in to start 
them, if these prefixes are unambiguous, thus '%ex' would 
normally restart a suspended ex(l) job, if there were only 
one suspended job whose name began with the string 'ex'. It 
is also possible to say '%?string' which specifies a job 
whose text contains string , if there is only one such job. 

The shell maintains a notion of the current and previous 
jobs. In output pertaining to jobs, the current job is 
marked with a '+' and the previous job with a '-'. The 
abbreviation '%+' refers to the current job and '%-' refers 
to the previous job. For close analogy with the syntax of 
the history mechanism (described below), '%%' is also a 
synonym for the current job. 

Status reporting 

This shell learns immediately whenever a process changes 
state. It normally informs you whenever a job becomes 
blocked so that no further progress is possible, but only 
just before it prints a prompt. This is done so that it 
does not otherwise disturb your work. If, however, you set 
the shell variable notify , the shell will notify you immedi- 
ately of changes of status in background jobs. There is 
also a shell command notify which marks a single process so 
that its status changes will be immediately reported. By 
default notify marks the current process; simply say 
'notify' after starting a background job to mark it. 
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When you try to leave the shell while jobs are stopped, you 
will be warned that 'You have stopped jobs.' You may use 
the jobs command to see what they are. If you do this or 
immediately try to exit again, the shell will not warn you a 
second time, and the suspended jobs will be terminated. 

Substitutions 

We now describe the various transformations the shell per- 
forms on the input in the order in which they occur. 

History substitutions 

History substitutions place words from previous command 
input as portions of new commands, making it easy to repeat 
commands, repeat arguments of a previous command in the 
current command, or fix spelling mistakes in the previous 
command with little typing and a high degree of confidence. 
History substitutions begin with the character '!' and may 
begin anywhere in the input stream (with the proviso that 
they do not nest.) This '!' may be preceded by an '\' to 
prevent its special meaning; for convenience, a ' ' ' is 
passed^ unchanged when it is followed by a blank, tab] new- 
line, '=• or •('. (History substitutions also occur when an 
input line begins with '-'. This special abbreviation will 
be described later.) Any input line which contains history 
substitution is echoed on the terminal before it is executed 
as It could have been typed without history substitution. 

Commands input from the terminal which consist of one or 
more words are saved on the history list. The history sub- 
stitutions reintroduce sequences of words from these saved 
commands into the input stream. The size of which is con- 
trolled by the history variable; the previous command is 
always retained, regardless of its value. Commands are num- 
bered sequentially from 1. 



For def initeness, consider the following output from the 
history command: 

9 write michael 

10 ex write. c 

11 cat oldwrite.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not 

usually necessary to use event numbers, but the current 

event number can be made part of the prompt by placing an 
••• in the prompt string. 

With the current event 13 we can refer to previous events by 
event number '111', relatively as in '!-2' (referring to the 
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same event), by a prefix of a command word as in ' !d for 
event 12 or Mwri' for event 9, or by a string contained in 
a word in the command as in MTmic?' also referring to event 
9. These forms, without further modification, simply rein- 
troduce the words of the specified events, each separated by 
a single blank. As a special case '!!' refers to the previ- 
ous command; thus '!!' alone is essentially a redo. 

To select words from an event we can follow the event 
specification by a ':' and a designator for the desired 
words. The words of a input line are numbered from 0, the 
first (usually command) word being 0, the second word (first 
argument) being 1, etc. The basic word designators are: 

first (command) word 

n n'th argument 

^ Tirst argument, i.e. '1' 

$ last argument 

% word matched by (immediately preceding) ?s? search 

x-^ range of words 

-y abbreviates '0-y' 

* abbreviates '^-$', or nothing if only 1 word in event 

X* abbreviates 'x-$' 

X- like 'x*' but omitting word '$' 

The ':' separating the event specification from the word 
designator can be omitted if the argument selector begins 
with a "^\ '$', '*' '-' or '%'. After the optional word 
designator can be placed a sequence of modifiers, each pre- 
ceded by a ':'. The following modifiers are defined: 

h Remove a trailing pathname component, 

leaving the head, 
r Remove a trailing ' .xxx' component, leaving 

the root name, 
e Remove all but the extension '.xxx' part, 
s/l/r/ Substitute 1. for r 
t Remove all leading pathname components, leaving 

the tail. 
Sc Repeat the previous substitution. 
g Apply the change globally, prefixing the above, 

for example, 'g&' . 
p Print the new command but do not execute it. 
q Quote the substituted words, preventing further 

substitutions. 
x Like q, but break into words at blanks, tabs 

and newlines. 

Unless preceded by a 'g' the modification is applied only to 
the first modifiable word. With substitutions, it is an 
error for no word to be applicable. 
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The left hand side of substitutions are not regular exores- 

sions in the sense of the editors, but rather strings. Any 

character may be used as the delimiter in place of '/'• a 

\ quotes the delimiter into the 1 and r strings. 'The 

frnm^'^^^o t fJ" ^^f f!?^^ ^^"^ =^^^ is'replaced by the text 
from the left. A '\' quotes '&' also. A null 1 uses the 
previous string either from a 1 or from a contextual scan 
string s in '!?s?'. The trailing delimiter in the substitu- 
tion may be omitted if a newline follows immediately as may 
the trailing '?• in a contextual scan. 

A history reference may be given without an event specifica- 
tion, e.g. !$'. In this case the reference is to the pre- 
vious command unless a previous history reference occurred 
on the same line in which case this form repeats the previ- 
ous reference. Thus •!?foo?-!$' gives the first and last 
arguments from the command matching '?foo?'. 

A special abbreviation of a history reference occurs when 
the first non-blank character of an input line is a "^• 
This is equivalent to 'l-s-' providing a convenient short- 

Th.'Ic -?K-i-K^^^-^''^'°u^ °" ^^^ ^^^^ °^ the previous line. 
Thus '^Ib-lib' fixes the spelling of 'lib' in the previous 
command Finally a history substitution may be surrounded 
with I and } If necessary to insulate it from the char- 
acters which follow. Thus, after 'Is -Id -paul' we might do 
!tl}a to do -Is -Id -paula', while Mia' would look for a 
command starting 'la'. 

Quotations with ' and " 

The quotation of strings by "• and "" can be used to 
prevent all or some of the remaining substitutions. Strinas 
enclosed in •" are prevented any further interpretation. 
Strings enclosed in "" are yet variable and command 
expanded as described below. 

In both cases the resulting text becomes (all or part of) a 
single word; only in one special case (see Comman d Substitu- 
tion below) does a "" quoted string yield~-^i?ti of more 
than one word; '" quoted strings never do. 

Alias substitution 

The shell maintains a list of aliases which can be esta- 
riim^n^; displayed and modified by the alias and unalias 
commands. After a command line is scanned"; — Tt is parsed 
into distinct commands and the first word of each command, 
left-to-right, is checked to see if it has an alias. if it 
does, then the text which is the alias for that command is 
reread with the history mechanism available as though that 
command were the previous input line. The resulting words 
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replace the command and argument list. If no reference is 
made to the history list, then the argxament list is left 
unchanged. 

Thus if the alias for 'Is' is 'Is -1' the command 'Is /usr' 
would map to 'Is -1 /usr', the argument list here being 
undisturbed. Similarly if the alias for 'lookup' was 'grep 
I'^/etc/passwd' then 'lookup bill' would map to 'grep bill 
/etc/passwd' . 

If an alias is found, the word transformation of the input 
text is performed and the aliasing process begins again on 
the reformed input line. Looping is prevented if the first 
word of the new text is the same as the old by flagging it 
to prevent further aliasing. Other loops are detected and 
cause an error. 

Note that the mechanism allows aliases to introduce parser 
metasyntax. Thus we can 'alias print 'pr \!* I Ipr' ' to 
make a command which pr's its arguments to the line printer. 

Variable substitution 

The shell maintains a set of variables, each of which has as 
value a list of zero or more words. Some of these variables 
are set by the shell or referred to by it. For instance, 
the argv variable is an image of the shell's argument list, 
and words of this variable's value are referred to in spe- 
cial ways. 

The values of variables may be displayed and changed by 
using the set and unset commands. Of the variables referred 
to by the shell a number are toggles; the shell does not 
care what their value is, only whether they are set or not. 
For instance, the verbose variable is a toggle which causes 
command input to be echoed. The setting of this variable 
results from the -v command line option. 

Other operations treat variables numerically. The '§' com- 
mand permits nxomeric calculations to be performed and the 
result assigned to a variable. Variable values are, how- 
ever, always represented as (zero or more) strings. For the 
purposes of numeric operations, the null string is con- 
sidered to be zero, and the second and subsequent words of 
multiword values are ignored. 

After the input line is aliased and parsed, and before each 
command is executed, variable substitution is performed 
keyed by '$' characters. This expansion can be prevented by 
preceding the '$' with a '\' except within ""s where it 
always occurs, and within '''s where it never occurs. 
Strings quoted by '"' are interpreted later (see Command 
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substitution below) so '$' substitution does not occur there 
until later, if at all. A '$• is passed unchanged if fol- 
lowed by a blank, tab, or end-of-line. 

Input/output redirections are recognized before variable 
expansion, and are variable expanded separately. Otherwise, 
the command name and entire argument list are expanded 
together. it is thus possible for the first (command) word 
to this point to generate more than one word, the first of 
which becomes the command name, and the rest of which become 
arguments. 

Unless enclosed in '"' or given the ' :q' modifier the 
results of variable substitution may eventually be command 
and filename substituted. Within '"'a variable whose value 
consists of multiple words expands to a (portion of) a sin- 
gle word, with the words of the variables value separated by 
blanks. When the ' :q' modifier is applied to a substitution 
the variable will expand to multiple words with each word 
separated by a blank and quoted to prevent later command or 
filename substitution. 

The following metasequences are provided for introducing 
variable values into the shell input. Except as noted, it 
IS an error to reference a variable which is not set. 

$name 

${name} 

Are replaced by the words of the value of variable 
name, each separated by a blank. Braces insulate name 
from following characters which would otherwise be part 
of it. Shell variables have names consisting of up to 
20 letters and digits starting with a letter. The 
underscore character is considered a letter. 
If name is not a shell variable, but is set in the 
environment, then that value is returned (but : modif- 
iers and the other forms given below are not available 
in this case) . 

$name[selector] 

${name[selector]} 

May be used to select only some of the words from the 
value of name . The selector is subjected to '$' substi- 
tution and may consist of a single number or two 
numbers separated by a '-'. The first word of a vari- 
ables value is numbered '1'. If the first number of a 
range is omitted it defaults to '1'. if the last 
member of a range is omitted it defaults to '$#name' 
The selector '*' selects all words. It is not an error 
for a range to be empty if the second argument is omit- 
ted or in range. 
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$#name 
${#name} 

Gives the number of words in the variable. This is 

useful for later use in a '[selector]'. 



$0 



Substitutes the name of the file from which command 
input is being read. An error occurs if the name is 
not known. 



$ number 
$ {number} 

Equivalent to ' $argv[ number] ' . 

$* 

Equivalent to '$argv[*]'. 

The modifiers ' :h' , ':t', ':r', ' :q' and ' :x' may be applied 
to the substitutions above as may ' :gh' , 'tgt' and ':gr'. 
If braces '{' '}' appear in the command form then the modif- 
iers must appear within the braces. The current implementa- 
tion allows only one ':' modifier on each '$' expansion. 

The following substitutions may not be modified with ':' 
modifiers. 

$?name 
${?name} 

Substitutes the string '1' if name is set, '0' if it is 

not. 



$?0 



$$ 



$< 



Substitutes '1' if the current input filename is known, 
'0' if it is not. 



Substitute the (decimal) process number of the (parent) 
shell. 



Substitutes a line from the standard input, with no 
further interpretation thereafter. It can be used to 
read from the keyboard in a shell script. 

Command and filename substitution 

The remaining substitutions, command and filename substitu- 
tion, are applied selectively to the arguments of builtin 
commands. This means that portions of expressions which are 
not evaluated are not subjected to these expansions. For 
commands which are not internal to the shell, the command 
name is substituted separately from the argument list. This 
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occurs very late, after input-output redirection is per- 
formed, and in a child of the main shell. 

Command substitution 

Command substitution is indicated by a command enclosed in 
' . The output from such a command is normally broken into 
separate words at blanks, tabs and newlines, with null words 
being discarded, this text then replacing the original 
string. Within '"'s, only newlines force new words; blanks 
and tabs are preserved. 

In any case, the single final newline does not force a new 
word. Note that it is thus possible for a command substitu- 
tion to yield only part of a word, even if the command out- 
puts a complete line. 

Filename substitution 

If a word contains any of the characters '*', '?', '[' or 
'{• or begins with the character '-', then that word is a 
candidate for filename substitution, also known as 'glob- 
bing'. This word is then regarded as a pattern, and 
replaced with an alphabetically sorted list of file names 
which match the pattern. in a list of words specifying 
filename substitution it is an error for no pattern to match 
an existing file name, but it is not required for each pat- 
tern to match. Only the metacharacters '*', '?' and '[' 
imply pattern matching, the characters '-' and '{' being 
more akin to abbreviations. 

In matching filenames, the character '.'at the beginning of 
a filename or immediately following a '/', as well as the 
character '/' must be matched explicitly. The character '*' 
matches any string of characters, including the null string. 
The character '?' matches any single character. The 
sequence '[...]' matches any one of the characters enclosed. 
Within '[...]', a pair of characters separated by '-' 
matches any character lexically between the two. 

The character '-' at the beginning of a filename is used to 
refer to home directories. Standing alone, i.e. '~' it 
expands to the invokers home directory as reflected in the 
value of the variable home. When followed by a name consist- 
ing of letters, digits and '-' characters the shell searches 
for a user with that name and substitutes their home direc- 
tory; thus '~ken' might expand to '/usr/ken' and 
'~ken/chmach' to Vusr/ken/chmach' . If the character '-' is 
followed by a character other than a letter or '/' or 
appears not at the beginning of a word, it is left undis- 
turbed. 
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The metanotation 'a{b,c,d}e' is a shorthand for 'abe ace 
ade'. Left to right order is preserved, with results of 
matches being sorted separately at a low level to preserve 
this order. This construct may be nested. Thus 
'~source/sl/{oldls, Is} .c' expands to '/usr/source/sl/oldls.c 
/usr/source/sl/ls.c' whether or not these files exist 
without any cnance of error if the home directory for 
'source' is '/usr/source' . Similarly ' . ./{memo,*box} ' might 
expand to '../memo ../box ../mbox'. (Note that 'memo' was 
not sorted with the results of matching '*box'.) As a spe- 
cial case '{', '}' and '{}' are passed undisturbed. 

Input /output 

The standard input and standard output of a command may be 
redirected with the following syntax: 

< name 

Open file name (which is first variable, command and 
filename expanded) as the standard input. 

<< word 

Read the shell input up to a line which is identical to 
word. Word is not subjected to variable, filename or 
command substitution, and each input line is compared 
to word before any substitutions are done on this input 
line. Unless a quoting '\', ' "' , ''' or '^' appears in 
word variable and command substitution is performed on 
the intervening lines, allowing '\' to quote '$', '\' 
and '"'. Commands which are substituted have all 
blanks, tabs, and newlines preserved, except for the 
final newline which is dropped. The resultant text is 
placed in an anonymous temporary file which is given to 
the command as standard input. 

> name 

> ! name 

>Sc name 

>& ! name 

The file name is used as standard output. If the file 
does not exist then it is created; if the file exists, 
its is truncated, its previous contents being lost. 

If the variable no clobber is set, then the file must 
not exist or be a character special file (e.g. a termi- 
nal or '/dev/null') or an error results. This helps 
prevent accidental destruction of files. In this case 
the ' ! ' forms can be used and suppress this check. 

The forms involving '&' route the diagnostic output 
into the specified file as well as the standard output. 
Name is expanded in the same way as '<' input filenames 
are. 
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>> name 
>>& name 

» ! name 

»&! name 

Uses file name as standard output like '>' but places 
output at the end of the file. If the variable 
noclobber is set, then it is an error for the file not 
to exist unless one of the ' ! ' forms is given. Other- 
wise similar to '>'. 

A command receives the environment in which the shell was 
invoked as modified by the input-output parameters and the 
presence of the command in a pipeline. Thus, unlike some 
previous shells, commands run from a file of shell commands 
have no access to the text of the commands by default; 
rather they receive the original standard input of the 
shell. The '«' mechanism should be used to present inline 
data. This permits shell command scripts to function as 
components of pipelines and allows the shell to block read 
its input. Note that the default standard input for a com- 
mand run detached is not modified to be the empty file 
Vdev/null"; rather the standard input remains as the origi- 
nal standard input of the shell. If this is a terminal and 
if the process attempts to read from the terminal, then the 
process will block and the user will be notified (see Jobs 
above . ) 

Diagnostic output may be directed through a pipe with the 
standard output. Simply use the form '!&' rather than just 
•I'. 

Expressions 

A number of the built in commands (to be described subse- 
quently) take expressions, in which the operators are simi- 
lar to those of C, with the same precedence. These expres- 
sions appear in the @, exit , if , and while commands. The 
following operators are available: 

II && I '^ St == != =~ i~ <=>=<>«» + 

*/%!-() 

Here the precedence increases to the right, '==' '!=' '=-' 
and '!-', '<=' '>=' '<' and '>', '«' and '»', ' + ' and '-', 
'*' '/• and '%' being, in groups, at the same level. The 
'==1 '1=' '=~' and ' !~' operators compare their arguments as 
strings; all others operate on numbers. The operators '=~' 
and '!-• are like '!=' and '==' except that the right hand 
side is a pattern (containing, e.g. '*'s, '?'s and instances 
of '[...]') against which the left hand operand is matched. 
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This reduces the need for use of the switch statement in 
shell scripts when all that is really needed is pattern 
matching. 

Strings which begin with '0' are considered octal numbers. 
Null or missing arguments are considered '0'. The result of 
all expressions are strings, which represent decimal 
numbers. It is important to note that no two components of 
an expression can appear in the same word; except when adja- 
cent to components of expressions which are syntactically 
significant to the parser {'&' 'I' '<' ">' '(' ')') they 
should be surrounded by spaces. 

Also available in expressions as primitive operands are com- 
mand executions enclosed in '{' and '}' and file enquiries 
of the form '-1 name' where 1 is one of: 



r 


read access 


w 


write access 


x 


execute access 


e 


existence 


o 


ownership 


z 


zero size 


f 


plain file 


d 


directory 



The specified name is command and filename expanded and then 
tested to see if it has the specified relationship to the 
real user. If the file does not exist or is inaccessible 
then all enquiries return false, i.e. '0'. Command execu- 
tions succeed, returning true, i.e. '1', if the command 
exits with status 0, otherwise they fail, returning false, 
i.e. '0'. If more detailed status information is required 
then the command should be executed outside of an expression 
and the variable status examined. 

Control flow 

The shell contains a number of commands which can be used to 
regulate the flow of control in command files (shell 
scripts) and (in limited but useful ways) from terminal 
input. These commands all operate by forcing the shell to 
reread or skip in its input and, due to the implementation, 
restrict the placement of some of the commands. 

The foreach , switch, and while statements, as well as the 

if - then - else form of the i_f statement require that the major 

keywords appear in a single simple command on an input line 
as shown below. 

If the shell's input is not seekable, the shell buffers up 
input whenever a loop is being read and performs seeks in 
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this internal buffer to accomplish the rereading implied by 
the loop. (To the extent that this allows, backward goto's 
will succeed on non-seekable inputs.) 

Bui It in commands 

Bui It in commands are executed within the shell. If a buil- 
tin command occurs as any component of a pipeline except the 
last then it is executed in a subshell. 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form 
prints the alias for name. The final form assigns the 
specified wordlist as the alias of name ; wordlist is 
command and filename substituted. Name is not allowed 
to be alias or unalias . 

alloc 

Shows the amount of dynamic core in use, broken down 
into used and free core, and address of the last loca- 
tion in the heap. With an argument shows each used and 
free block on the internal dynamic memory chain indi- 
cating its address, size, and whether it is used or 
free. This is a debugging command and may not work in 
production versions of the shell; it requires a modi- 
fied version of the system memory allocator. 

bg 

bg %job . .. 

Puts the current or specified jobs into the background, 

continuing them if they were stopped. 

break 

Causes execution to resume after the end of the nearest 
enclosing foreach or while . The remaining commands on 
the current line are executed. Multi-level breaks are 
thus possible by writing them all on one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 

case label: 

A label in a switch statement as discussed below. 

cd 

cd name 

chdir 

chdir name 

Change the shells working directory to directory name. 

If no argument is given then change to the~hoitie 
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directory of the user. 

If name is not found as a subdirectory of the current 
directory (and does not begin with '/', ' ./' or '../'), 
then each component of the variable cdpath is checked 
to see if it has a subdirectory name . Finally, if all 
else fails but name is a shell variable whose value 
begins with '/', then this is tried to see if it is a 
directory. 

continue 

Continue execution of the nearest enclosing while or 
foreach. The rest of the commands on the current line 
are executed. 

default: 

Labels the default case in a switch statement. The 



default should come after all case labels. 



dirs 



Prints the directory stack; the top of the stack is at 
the left, the first directory in the stack being the 
current directory. 

echo wordlist 

echo -n wordlist 

The specified words are written to the shells standard 
output, separated by spaces, and terminated with a new- 
line unless the -n option is specified. 

else 
end 
endif 
endsw 

See the description of the foreach, ^, switch, and 

while statements below. 

eval arg . . . 

(As in sh(l).) The arguments are read as input to the 
shell and the resulting command(s) executed. This is 
usually used to execute commands generated as the 
result of command or variable substitution, since pars- 
ing occurs before these substitutions. See tset(l) for 
an example of using eval . 

exec command 

The specified command is executed in place of the 
current shell. 

exit 

exit(expr) 

The shell exits either with the value of the status 
variable (first form) or with the value of the 
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specified expr (second form). 

fg 

fg %job . . . 

Brings the current or specified jobs into the fore- 
ground, continuing them if they were stopped. 

foreach name (wordlist) 

• • • 

end 

The variable name is successively set to each member of 
vordlist and the sequence of commands between this com- 
mand and the matching end are executed. (Both foreach 
and end must appear alone on separate lines.) 

The built in command continue may be used to continue 
the loop prematurely and the built in command break to 
terminate it prematurely. When this command Is read 
from the terminal, the loop is read up once prompting 
with '?' before any statements in the loop are exe- 
cuted. If you make a mistake typing in a loop at the 
terminal you can rub it out. 

glob wordlist 

Like echo but no '\' escapes are recognized and words 
are delimited by null characters in the output. Useful 
for programs which wish to use the shell to filename 
expand a list of words. 

goto word 

The specified word is filename and command expanded to 
yield a string of the form 'label'. The shell rewinds 
its input as much as possible and searches for a line 
of the form 'label:' possibly preceded by blanks or 
tabs. Execution continues after the specified line. 

hashstat 

Print a statistics line indicating how effective the 
internal hash table has been at locating commands (and 
avoiding exec 's) . An exec is attempted for each com- 
ponent of the path where the hash function indicates a 
possible hit, and in each component which does not 
begin with a '/' . 

history 

history n 

history -r n 

Displays the history event list; if n is given only the 
n most recent events are printed. The -r option rev- 
erses the order of printout to be most recent first 
rather than oldest first. 
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if (expr) command 

If the specified expression evaluates true, then the 
single command with arguments is executed. Variable 
substitution on command happens early, at the same time 
it does for the rest of the jj_ command. Command must 
be a simple command, not a pipeline, a command list, or 
a parenthesized command list. Input/output redirection 
occurs even if expr is false, when command is not exe- 
cuted (this is a bug). 

if (expr) then 

• • • 

else if (expr2) then 

• • • 

else 

• • • 

end if 

If the specified expr is true then the commands to the 
first else are executed; else if expr2 is true then the 
commands to the second else are executed, etc. Any 
number of else - if pairs are possible; only one end if is 
needed. The else part is likewise optional"^ TThe 
words else and end if must appear at the beginning of 
input lines; the if must appear alone on its input line 
or after an else .T" 

jobs 

jobs -1 

Lists the active jobs; given the -1 options lists pro- 
cess id's in addition to the normal information. 

kill %job 

kill -sig %job ... 

kill pid 

kill -sig pid . . . 

kill -1 

Sends either the TERM (terminate) signal or the speci- 
fied signal to the specified jobs or processes. Sig- 
nals are either given by number or by names (as given 
in / usr / include / signal . h, stripped of the prefix 
'SIG'). The signal names are listed by 'kill -1'. 
There is no default, saying just 'kill' does not send a 
signal to the current job. If the signal being sent is 
TERM (terminate) or HUP (hangup), then the job or pro- 
cess will be sent a CONT (continue) signal as well. 

limit 

limit resource 

limit resource maximum - use 

(Vax only.) Limits the consumption by the current pro- 
cess and each process it creates to not individually 
exceed maximum - use on the specified resource . If no 
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maximum - use is given, then the current limit is 
printed; if no resource is given, then all limitations 
are given. 

Resources controllable currently include cputime (the 
maximiom number of cpu-seconds to be used by each pro- 
cess) , filesize (the largest single file which can be 
created!^ datasize (the maximum growth of the 
data+stack region via sbrk(2) beyond the end of the 
program text), stacksize (the maximum size of the 
automatically-extended stack region), and coredumpsize 
(the size of the largest core dump thit will be 
created) . 

The maximum - use may be given as a (floating point or 
integer) number followed by a scale factor. For all 
limits other than cputime the default scale is 'k' or 
'kilobytes' (1024 bytes); a scale factor of 'm' or 
'megabytes' may also be used. For cputime the default 
scaling is 'seconds', while 'm' for minutes or 'h' for 
hours, or a time of the form 'mmrss' giving minutes and 
seconds may be used. 

For both resource names and scale factors, unambiguous 
prefixes of the names suffice. 

login 

Terminate a login shell, replacing it with an instance 
of /bin/login. This is one way to log off, included for 
compatibility with sh(l). 

logout 

Terminate a login shell. Especially useful if 
ignoreeof is set. 

newgrp 

Changes the group identification of the caller; for 
details see newgrp (l) . A new shell is executed by 
newgrp so that the shell state is lost. 

nice 

nice +number 

nice command 

nice +number command 

The first form sets the nice for this shell to 4. The 
second form sets the nice to the given number. The 
final two forms run command at priority 4 and number 
respectively. The superuser may specify negative nice- 
ness by using 'nice -number ...'. Command is always 
executed in a sub-shell, and the restrictions place on 
commands in simple If statements apply. 
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nohup 

nohup command 

The first form can be used in shell scripts to cause 
hangups to be ignored for the remainder of the script. 
The second form causes the specified command to be run 
with hangups ignored. All processes detached with '&' 
are effectively nohup ' ed . 

notify 

notify %job . . . 

Causes the shell to notify the user asynchronously when 

the status of the current or specified jobs changes; 

normally notification is presented before a prompt. 

This is automatic if the shell variable notify is set. 

onintr 

onintr 

onintr label 

Control the action of the shell on interrupts. The 
first form restores the default action of the shell on 
interrupts which is to terminate shell scripts or to 
return to the terminal command input level. The second 
form 'onintr -' causes all interrupts to be ignored. 
The final form causes the shell to execute a 'goto 
label' when an interrupt is received or a child process 
terminates because it was interrupted. 

In any case, if the shell is running detached and 
interrupts are being ignored, all forms of onintr have 
no meaning and interrupts continue to be ignored by the 
shell and all invoked commands. 

popd 

popd +n 

Pops the directory stack, returning to the new top 
directory. With a argument '+n' discards the nth entry 
in the stack. The elements of the directory stack are 
niombered from starting at the top. 

pushd 

pushd name 

pushd +n 

With no arguments, pushd exchanges the top two elements 
of the directory stack. Given a name argument, pushd 
changes to the new directory {ala ccTJ and pushes the 
old current working directory Tas in csw) onto the 
directory stack. With a numeric argument, rotates the 
nth argument of the directory stack around to be the 
top element and changes to it. The members of the 
directory stack are numbered from the top starting at 
0. 
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rehash 

Causes the internal hash table of the contents of the 
directories in the path variable to be recomputed. 
This is needed if new commands are added to directories 
in the path while you are logged in. This should only 
be necessary if you add commands to one of your own 
directories, or if a systems programmer changes the 
contents of one of the system directories. 

repeat count command 

The specified command which is subject to the same res- 
trictions as the command in the one line ^1 statement 
above, is executed count times. I/O redirections occur 
exactly once, even if count is 0. 

set 

set name 

set name=word 

set name [ index] =word 

set name=(wordlist) 

The first form of the command shows the value of all 
shell variables. Variables which have other than a 
single word as value print as a parenthesized word 
list. The second form sets name to the null string. 
The third form sets name to the single word . The fourth 
form sets the index ' th component of name to word; this 
component must already exist. The final form sets name 
to the list of words in wordlist . In all cases the 
value is command and filename expanded. 

These arguments may be repeated to set multiple values 
in a single set command. Note however, that variable 
expansion happens for all arguments before any setting 
occurs. 

setenv name value 

Sets the value of environment variable name to be 
value, a single string. The most commonly used 
environment variable USER, TERM, and PATH are automati- 
cally imported to and exported from the csh variables 
user, term, and path ; there is no need to use setenv 
for these. 

shift 

shift variable 

The members of argv are shifted to the left, discarding 
argv [l] . It is an error for argv not to be set or to 
have less than one word as value. The second form per- 
forms the same function on the specified variable. 

source name 

The shell reads commands from name . Source commands may 
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be nested; if they are nested too deeply the shell may 
run out of file descriptors. An error in a source at 
any level terminates all nested source commands. Input 
during source commands is never placed on the history 
list. 

stop 

stop %job ... , . ^ . 

Stops the current or specified ]ob which is executing 

in the background. 

suspend , - c • *. 

Causes the shell to stop in its tracks, much as if it 

had been sent a stop signal with ^Z. This is most 

often used to stop shells started by su(l). 

switch (string) 
case strl: 

• • • 

breaksw 

• • • 

default: 

■ • • 

breaksw 
endsw , 

Each case label is successively matched, against the 
specified string which is first command and filename 
expanded. The file metacharacters '*', '?' and '[...]' 
may be used in the case labels, which are variable 
expanded. If none of the labels match before a 
'default' label is found, then the execution begins 
after the default label. Each case label and the 
default label must appear at the beginning of a line. 
The command breaksw causes execution to continue after 
the endsw. Otherwise control may fall through case 
labels and default labels as in C. If no label matches 
and there is no default, execution continues after the 
endsw. 

time 

t ime command 

With no argument, a summary of time used by this shell 
and its children is printed. If arguments are given 
the specified simple command is timed and a time sum- 
mary as described under the time variable is printed. 
If necessary, an extra shell is created to print the 
time statistic when the command completes. 

ximask 

umask value 

The file creation mask is displayed (first form) or set 
to the specified value (second form). The mask is 
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given in octal. Common values for the mask are 002 
giving all access to the group and read and execute 
access to others or 022 giving all access except no 
write access for users in the group or others. 

unalias pattern 

All aliases whose names match the specified pattern are 
discarded. Thus all aliases are removed by 'unalias 
. It IS not an error for nothing to be unaliased . 

unhash 

Use of the internal hash table to speed location of 
executed programs is disabled. 

unlimit resource 
unlimit 

(Vax only.) Removes the limitation on resour ce. If no 
resource is specified, then all resource limitations 
are removed. 

unset pattern 

All variables whose names match the specified pattern 
are removed. Thus all variables are removed by 'unset 
; this has noticeably distasteful side-effects it 
IS not an error for nothing to be unset . 

unsetenv pattern 

Removes all variables whose name match the specified 

SfnJ^""!! ^^^ environment. See also the setenv com- 
mand above and printenv (l) . 

wait 

All background jobs are waited for. It the shell is 
interactive, then an interrupt can disrupt the wait, at 
which time the shell prints names and job numbers of 
all jobs known to be outstanding. 

while (expr) 

• • • 

end 

While the specified expression evaluates non-zero, the 
commands between the while and the matching end are 
evaluated. Break and continue may be used to terminate 
or continue the loop prematurely. (The while and end 
must appear alone on their input lines7r~PromptTHi 
occurs here the first time through the loop as for the 
foreach statement if the input is a terminal 



%job 



Brings the specified job into the foreground. 
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%job Sc 

Continues the specified job in the background. 

Q 

@ name = expr 

§ name [index] = expr 

The first form prints the values of all the shell vari- 
ables. The second form sets the specified name to the 
value of expr . If the expression contains '<', '>', '&' 
or 'I' then at least this part of the expression must 
be placed within '(' ')'. The third form assigns the 
value of expr to the index ' th argument of name . Both 
name and its index ' th component must already exist. 

The operators '*=', '+=', etc are available as in C. 
The space separating the name from the assignment 
operator is optional. Spaces are, however, mandatory 
in separating components of expr which would otherwise 
be single words. 

Special postfix '++' and ' — ' operators increment and 
decrement name respectively, i.e. '§ i++'. 

Pre-defined and environment variables 

The following variables have special meaning to the shell. 
Of these, argv , cwd, home , path , prompt , shell and status 
are always set by the shell. Except for cwd and status this 
setting occurs only at initialization; these variables will 
not then be modified unless this is done explicitly by the 
user. 

This shell copies the environment variable USER into the 
variable user , TERM into term , and HOME into home, and 
copies these back into the environment whenever the normal 
shell variables are reset. The environment variable PATH is 
likewise handled; it is not necessary to worry about its 
setting other than in the file . cshrc as inferior csh 
processes will import the definition of path from the 
environment, and re-export it if you then change it. (It 
could be set once in the . login except that commands through 
net(l) would not see the definition.) 

argv Set to the arguments to the shell, it is from 

this variable that positional parameters are 
substituted, i.e. '$1' is replaced by 
'$argv[l] ' , etc. 

cdpath Gives a list of alternate directories 
searched to find subdirectories in chdir com- 
mands. 
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cwd 
echo 



history 



home 



ignoreeof 



mail 



The full pathname of the current directory. 

Set when the -x command line option is given. 
Causes each command and its arguments to be 
echoed just before it is executed. For non- 
built in commands all expansions occur before 
echoing. Bui It in commands are echoed before 
command and filename substitution, since 
these substitutions are then done selec- 
tively. 

Can be given a niomeric value to control the 
size of the history list. Any command which 
has been referenced in this many events will 
not be discarded. Too large values of his- 
tory may run the shell out of memory. "The 
last executed command is always saved on the 
history list. 

The home directory of the invoker, initial- 
ized from the environment. The filename 
expansion of '~' refers to this variable. 

If set the shell ignores end-of-file from 
input devices which are terminals. This 
prevents shells from accidentally being 
killed by control-D's. 

The files where the shell checks for mail. 
This is done after each command completion 
which will result in a prompt, if a specified 
interval has elapsed. The shell says 'You 
have new mail.' if the file exists with an 
access time not greater than its modify time. 

If the first word of the value of mail is 
numeric it specifies a different mail check- 
ing interval, in seconds, than the default, 
which is 10 minutes. 



If multiple mail files are 
the shell says 'New mail in 
is mail in the file name. 



specified, 
name ' when 



then 
there 



noclobber 



nog lob 



As described in the section on I nput / output , 
restrictions are placed on output redirection 
to insure that files are not accidentally 
destroyed, and that '»' redirections refer 
to existing files. 

If set, filename expansion is inhibited. 
This is most useful in shell scripts which 
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nonomatch 



notify 



path 



prompt 



shell 



status 



are not dealing with filenames, or after a 
list of filenames has been obtained and 
further expansions are not desirable. 

If set, it is not an error for a filename 
expansion to not match any existing files; 
rather the primitive pattern is returned. It 
is still an error for the primitive pattern 
to be malformed, i.e. 'echo [' still gives 
an error. 

If set, the shell notifies asynchronously of 
job completions. The default is to rather 
present job completions just before printing 
a prompt. 

Each word of the path variable specifies a 
directory in which commands are to be sought 
for execution. A null word specifies the 
current directory. If there is no path vari- 
able then only full path names will execute. 
The usual search path is '.', '/bin' and 
'/usr/bin', but this may vary from system to 
system. For the superuser the default search 
path is '/etc', '/bin' and '/usr/bin'. A 
shell which is given neither the -c nor the 
-t option will normally hash the contents of 
the directories in the path variable after 
reading . cshrc , and each time the path vari- 
able is reset. If new commands are added to 
these directories while the shell is active, 
it may be necessary to give the rehash or the 
commands may not be found. 

The string which is printed before each com- 
mand is read from an interactive terminal 
input. If a '!' appears in the string it 
will be replaced by the current event number 
unless a preceding '\' is given. Default is 
'% ', or '# ' for the superuser. 

The file in which the shell resides. This is 
used in forking shells to interpret files 
which have execute bits set, but which are 
not executable by the system. (See the 
description of Non - builtin Command Execution 
below.) Initialized to the ( system-dependent ) 
home of the shell. 

The status returned by the last command. If 
it terminated abnormally, then 0200 is added 
to the status. Builtin commands which fail 
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return exit status '1', all other builtin 
commands set status '0'. 

^^■^^ Controls automatic timing of commands. If 

set, then any command which takes more than 
this many cpu seconds will cause a line giv- 
ing user, system, and real times and a utili- 
zation percentage which is the ratio of user 
plus system times to real time to be printed 
when it terminates. 

verbose Set by the -v command line option, causes the 
words of each command to be printed after 
history substitution. 

Non-built in command execution 

When a command to be executed is found to not be a builtin 
command the shell attempts to execute the command via 
execve(2). Each word in the variable path names a directory 
from which the shell will attempt to execute the command. 
It It is given neither a -c nor a -t option, the shell will 
hash the names in these directories into an internal table 
so that It will only try an exec in a directory if there is 
a possibility that the command resides there. This greatly 
speeds command location when a large number of directories 
are present in the search path. If this mechanism has been 
turned off (via unhash ) , or if the shell was given a -c or 
-t argument, and m any case for each directory component of 
£ath which does not begin with a V, the shell concatenates 
with the given command name to form a path name of a file 
which It then attempts to execute. 

Parenthesized commands are always executed in a subshell 
Thus '(cd ; pwd) ; pwd' prints the home directory; leaving 
you where you were (printing this after the home directory), 
while cd ; pwd' leaves you in the home directory. 
Parenthesized commands are most often used to~prevent chdir 
from affecting the current shell. 

If the file has execute permissions but is not an executable 
binary to the system, then it is assumed to be a file con- 
taining shell commands an a new shell is spawned to read it. 

If there is an alias for shell then the words of the alias 
will be prepended to the argument list to form the shell 
command. The first word of the alias should be the full 
path name of the shell (e.g. ■$shell'). Note that this is a 
special, late occurring, case of alias substitution, and 
only allows words to be prepended to the argument list 
without modification. 
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Argument list processing 

If argument to the shell is '-' then this is a login 
shell. The flag arguments are interpreted as follows: 

-c Commands are read from the (single) following argument 
which must be present. Any remaining arguments are 
placed in argv . 

-e The shell exits if any invoked command terminates 
abnormally or yields a non-zero exit status. 

-f The shell will start faster, because it will neither 
search for nor execute commands from the file ' .cshrc' 
in the invokers home directory. 

-i The shell is interactive and prompts for its top-level 
input, even if it appears to not be a terminal. Shells 
are interactive without this option if their inputs and 
outputs are terminals. 

-n Commands are parsed, but not executed. This may aid in 
syntactic checking of shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A '\' may 
be used to escape the newline at the end of this line 
and continue onto another line. 

-V Causes the verbose variable to be set, with the effect 
that command input is echoed after history substitu- 
tion. 

-X Causes the echo variable to be set, so that commands 
are echoed immediately before execution. 

-V Causes the verbose variable to be set even before 
' .cshrc' is executed. 

-X Is to -X as -V is to -V. 

After processing of flag arguments if arguments remain but 
none of the -c, -i, -s, or -t options was given the first 
argument is taken as the name of a file of commands to be 
executed. The shell opens this file, and saves its name for 
possible resubstitution by '$0'. Since many systems use 
either the standard version 6 or version 7 shells whose 
shell scripts are not compatible with this shell, the shell 
will execute such a 'standard' shell if the first character 
of a script is not a '#', i.e. if the script does not start 
with a comment. Remaining arguments initialize the variable 
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arqv . 

Signal handling 

The shell normally ignores quit signals. Jobs running 
detached (either by '&' or the ba or %... & commands) are 
immune to signals generated from the keyboard, including 
hangups. Other signals have the values which the shell 
inherited from its parent. The shells handling of inter- 
rupts and terminate signals in shell scripts can be con- 
trolled by onintr . Login shells catch the terminate signal; 
otherwise this signal is passed on to children from the 
state in the shell's parent. In no case are interrupts 
allowed when a login shell is reading the file '.logout'. 

AUTHOR 

William Joy. Job control and directory stack features first 
implemented by J.E. Kulp of I.I.A.S.A, Laxenburg, Austria, 
with different syntax than that used now. 

FILES 

~/.cshrc Read at beginning of execution by each shell. 

~/. login Read by login shell, after '.cshrc' at login. 

~/. logout Read by login shell, at logout, 

/bin/sh Standard shell, for shell scripts not 

starting with a '#'. 

/tmp/sh* Temporary file for '«'. 

/etc/passwd Source of home directories for '~name'. 

LIMITATIONS 

Words can be no longer than 1024 characters. The system 
limits argument lists to 10240 characters (5120 characters 
on most PDPll systems) . The number of arguments to a com- 
mand which involves filename expansion is limited to 1/6 'th 
the number of characters allowed in an argument list. Com- 
mand substitutions may substitute no more characters than 
are allowed in an argument list. To detect looping, the 
shell restricts the number of alias substitutions on a sin- 
gle line to 20. 

SEE ALSO 

oldcsh(l), sh(l), access(2), execve(2), fork(2), killpg(2), 
pipe(2), sigsys(2), umask(2), wait(2), exec(3), jobs(3), 
sigsetO), tty(4), a.out(5), environ(5), 'An introduction to 
the C shell' 

RESTRICTIONS 

When a command is restarted from a stop, the shell prints 
the directory it started in if this is different from the 
current directory; this can be misleading (i.e. wrong) as 
the job may have changed directories internally. 
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Shell built in functions are not stoppable/restartable. Com- 
mand sequences of the form 'a ; b ; c' are also not handled 
gracefully when stopping is attempted. If you suspend 'b', 
the shell will then immediately execute 'c'. This is espe- 
cially noticeable if this expansion results from an alias . 
It suffices to place the sequence of commands in ( ) ' s to 
force it to a subshell, i.e. '( a ; b ; c )'. 

Control over tty output after processes are started is prim- 
itive; perhaps this will inspire someone to work on a good 
virtual terminal interface. In a virtual terminal interface 
much more interesting things could be done with output con- 
trol. 

Alias substitution is most often used to clumsily simulate 
shell procedures; shell procedures should be provided rather 
than aliases. 

Commands within loops, prompted for by '?', are not placed 
in the history list. Control structure should be parsed 
rather than being recognized as built-in commands. This 
would allow control commands to be placed anywhere, to be 
combined with 'I', and to be used with '&' and ';' metasyn- 
tax. 

It should be possible to use the ':' modifiers on the output 
of command substitutions. All and more than one ':' modif- 
ier should be allowed on '$' substitutions. 
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NAME 

ctags - create a tags file 

SYNOPSIS 

ctags [ -BFatuwvx ] name . . . 

DESCRIPTION 

Ctags makes a tags file for ex(l) from the specified C, Pas- 
cal and Fortran sources. A tags file gives the locations of 
specified objects (in this case functions and typedefs) in a 
group of files. Each line of the tags file contains the 
object name, the file in which it is defined, and an address 
specification for the dbject definition. Functions are 
searched with a pattern, typedefs with a line number. 
Specifiers are given in separate fields on the line, 
separated by blanks or tabs. Using the tags file, ex can 
quickly find these object name definitions. 

If the -X flag is given, ctags produces a list of object 
names, the line number and file name on which each is 
defined, as well as the text of that line and prints this on 
the standard output. This is a simple index which can be 
printed out as an off-line readable function index. 

If the -V flag is given, an index of the form expected by 
vqrind (l) is produced on the standard output. This listing 
contains the function name, file name, and page number 
(assuming 64 line pages). Since the output will be sorted 
into lexicographic order, it may be desired to run the out- 
put through sort -f. Sample use: 

ctags -V files I sort -f > index 
vgrind -x index 

Files whose name ends in .c or .h are assumed to be C source 
files and are searched for C routine and macro definitions. 
Others are first examined to see if they contain any Pascal 
or Fortran routine definitions; if not, they are processed 
again looking for C definitions. 

Other options are: 

-B use backward searching patters (?...?). 

-F use forward searching patterns (/.../) (default). 

-a append to tags file. 

-t create tags for typedefs. 

-u causing the specified files to be updated in tags, that 
is, all references to them are deleted, and the new 
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values are appended to the file. (Beware: this option 
is implemented in a way which is rather slow; it is 
usually faster to simply rebuild the tags file.) 

-w suppressing warning diagnostics. 

The tag main is treated specially in C programs. The tag 
formed Is created by prepending M to the name of the file, 
with a trailing .c removed, if any, and leading pathname 
components also removed. This makes use of ctags practical 
in directories with more than one program. 

FILES 

tags output tags file 

SEE ALSO 

ex(l), vi(l) 

AUTHOR 

Ken Arnold; FORTRAN added by Jim Kleckner; Bill Joy added 
Pascal and -x, replacing cxref ; C typedefs added by Ed 
Pelegri-Llopart. 

RESTRICTIONS 

Recognition of functions , subroutines and procedures for 
FORTRAN and Pascal is done is a very simpleminded way. No 
attempt is made to deal with block structure; if you have 
two Pascal procedures in different blocks with the same name 
you lose. 

The method of deciding whether to look for C or Pascal and 
FORTRAN functions is a hack. 

ctags does not know about #ifdefs. 

Should know about Pascal types. Relies on the input being 
well formed to detect typedefs. Use of -tx shows only the 
last line of typedefs. 
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NAME 



tip, cu - connect to a remote system 



SYNOPSIS 

tip [ -V ] [ - speed ] system-name 
tip [ -V ] [ - speed ] phone-number 
cu phone -number [ -t ] [ -s speed ] [ 
[ -# ] 



-a acu ] [ -1 line 3 



connection to another 
being logged in directly 

saying that you must 
equivalent) to which you 



DESCRIPTION 

Tip and cu establish a full-duplex 

machine, giving the appearance of 

on the remote cpu. It goes without 

have a login on the machine (or 

wish to connect. The preferred interface is tip . The cu 

interface is included for those people attached to the 'caTT 

UNIX' command of version 7. This manual page describes only 

tip . 

Typed characters are normally transmitted directly to the 
remote machine (which does the echoing as well). A tilde 
('~') appearing as the first character of a line is an 
escape signal; the following are recognized: 



— D ~. 

~c [ name 3 



Drop the connection and exit (you may still be 
logged in on the remote machine). 



Change directory to name (no argument implies 
change to your home directory) . 

Escape to a shell (exiting the shell will return 
you to tip) . 



~> 



Copy file from local to remote. Tip prompts 
the name of a local file to transmit. 



for 



'< Copy file from remote to local. Tip prompts first 
for the name of the file to be sent, then for a 
command to be executed on the remote machine. 

-p from [ to ] 

Send a file to a remote UNIX host. The put com- 
mand causes the remote UNIX system to run the com- 
mand string 'cat > 'to' ', while tip sends it the 
'from' file. If the 'to' file isn't specified the 
'from' file name is used. This command is actu- 
ally a UNIX specific version of the '~>' command. 

-t from [ to ] 

Take a file from a remote UNIX host. As in the put 
command the 'to' file defaults to the 'from' file 
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name if it isn't specified. The remote host exe- 
cutes the command string 'cat 'from', -echo ^A ' to 
send the file to tip . 

~| Pipe the output from a remote command to a local 
UNIX process. The command string sent to the 
local UNIX system is processed by the shell. 

~# Send a BREAK to the remote system. For systems 
which don't support the necessary ioctl call the 
break is simulated by a sequence of line speed 
changes and DEL characters. 

~s Set a variable (see the discussion below). 

~'^Z Stop tip (only available with job control). 

~? Get a summary of the tilde escapes 

Tip uses the file /etc/remote to find how to reach a partic- 
ular system and to find out how it should operate while 
talking to the system; refer to remote (5) for a full 
description. Each system has a default baud rate with which 
to establish a connection. If this value is not suitable, 
the baud rate to be used may be specified on the command 
line, e.g. 'tip -300 mds'. 

When tip establishes a connection it sends out a connection 
message to the remote system; the default value, if any, is 
defined in /etc/remote. 

When tip prompts for an argument (e.g. during setup of a 
file transfer) the line typed may be edited with the stan- 
dard erase and kill characters. A null line in response to 
a prompt, or an interrupt, will abort the dialogue and 
return you to the remote machine. 

Tip guards against multiple users connecting to a remote 
system by opening modems and terminal lines with exclusive 
access, and by honoring the locking protocol used by 
uucp (lC) . 

During file transfers tip provides a running count of the 
number of lines transferred. When using the ~> and ~< com- 
mands, the 'eofread' and 'eofwrite' variables are used to 
recognize end-of-file when reading, and specify end-of-file 
when writing (see below). File transfers normally depend on 
tandem mode for flow control. If the remote system does not 
support tandem mode, 'echocheck' may be set to indicate tip 
should synchronize with the remote system on the echo of 
each transmitted character. 
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When tip must dial a phone number to connect to a system it 
will print various messages indicating its actions. Tip 
supports the DEC DN-11 and Racal-Vadic 831 auto-call-uniti^ 
the DEC DF02 and DF03, Ventel 212+ , Racal-Vadic 3451, and 
Bizcomp 1031 and 1032 integral call unit/modems. 

VARIABLES 

Tip maintains a set of variables which control its opera- 
tion. Some of these variable are read-only to normal users 
(root is allowed to change anything of interest). Variables 
may be displayed and set through the 's' escape. The syntax 
for variables is patterned after vj.(l) and Mail (l) . Supply- 
ing^ 'all' as an argument to the set command displays all 
variables readable by the user. Alternatively, the user may 
request display of a particular variable by attaching a '?' 
to the end. For example 'escape?' displays the current 
escape character. 

Variables are numeric, string, character, or boolean values. 
Boolean variables are set merely by specifying their name; 
they may be reset by prepending a '!' to the name. Other 
variable types are set by concatenating an ' = ' and the 
value. The entire assignment must not have any blanks in 
it. A single set command may be used to interrogate as well 
as set a number of variables. Variables may be initialized 
at run time by placing set commands (without the '~s' prefix 
in a file . tiprc in one's home directory). The -v option 
causes tjjg to display the sets as they are made. Certain 
common variables have abbreviations. The following is a list 
of common variables, their abbreviations, and their default 
values. 

beautify 

(bool) Discard unprintable characters when a session is 
being scripted; abbreviated be. 

baudrate 

(niun) The baud rate at which the connection was esta- 
blished; abbreviated ba. 

dialtimeout 

(num) When dialing a phone number, the time (in 
seconds) to wait for a connection to be established; 
abbreviated dial . 

echocheck 

(bool) Synchronize with the remote host during file 
transfer by waiting for the echo of the last character 
transmitted; default is off. 
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eof read 

(str) The set of characters which signify and end-of- 
transmission during a ~< file transfer command; abbre- 
viated eofr . 

eofwrite 

(str) The string sent to indicate end-of-transmission 
during a ~> file transfer command; abbreviated eofw. 

eol 

(str) The set of characters which indicate an end-of- 
line. Tip will recognize escape characters only after 
an end-of-line. 

escape 

(char) The command prefix (escape) character; abbrevi- 
ated es; default value is '~'. 

exceptions 

(str) The set of characters which should not be dis- 
carded due to the beautif ication switch; abbreviated 
ex ; default value is '\t\n\f\b'. 

force 

(char) The character used to force literal data 
transmission; abbreviated fo; default value is "^P' . 

framesize 

(num) The amount of data (in bytes) to buffer between 
file system writes when receiving files; abbreviated 
fr. 



host 



(str) The name of the host to which you are connected; 
abbreviated ho. 



prompt 

(char) The character which indicates and end-of-line on 
the remote host; abbreviated 21? default value is '\n'. 
This value is used to synchronize during data 
transfers. The count of lines transferred during a 
file transfer command is based on recipt of this char- 
acter. 

raise 

(bool) Upper case mapping mode; abbreviated ra; default 
value is off . When this mode is enabled, all lower 
case letters will be mapped to upper case by tip for 
transmission to the remote machine. 
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raisechar 

(char) The input character used to toggle upper case 
mapping mode; abbreviated re; default value 



IS 



^A' 



record 

(str) The name of the file 
recorded; abbreviated 
'tip. record' . 



in which a session script is 
rec; default value is 



script 

(bool) Session scripting mode; abbreviated sc; default 
is off. When script is true , tip will record every- 
thing transmitted by the remote machine in the script 
record file specified in record . If the beautify 
switch is on, only printable ASCII characters wTTI be 
included in the script file (those characters betwee 
040 and 0177). The variable exceptions is used to 
indicate characters which are an exception to the 
mal beautif ication rules. 



nor- 



tabexpand 

(bool) Expand tabs to spaces during file transfers; 
abbreviated tab; default value is false . Each tab is 
expanded to 8 spaces. 

verbose 

(bool) Verbose mode; abbreviated verb ; default is true. 
When verbose mode is enabled, tip prints messages while 
dialing, shows the current number of lines transferred 
during a file transfer operations, and more. 



SHELL 



(str) The name of 
default value is 
ment. 



the shell 
'/bin/sh'. 



to use for the ~! command; 
or taken from the environ- 



HOME 



(str) The home directory to use for the ~c 
default value is taken from the environment. 



FILES 



command; 



/etc/remote 

/etc/phones 

$ {REMOTE} 

$ {PHONES} 

~/.tiprc 

/usr/spool/uucp/LCK. .* 



global system descriptions 
global phone number data base 
private system descriptions 
private phone numbers 
initialization file, 
lock file to avoid conflicts with 



UUCP 



cu(ic) cudc) 



DIAGNOSTICS 

Diagnostics are, hopefully, self explanatory. 

SEE ALSO 

remote(5), phones(5) 

RESTRICTIONS 

The full set of variables is undocumented and should, prob- 
ably, be paired down. 
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NAME 

cu_v7 - call UNIX (original V7 version) 

SYNOPSIS 

cu_v7 telno [ -t ] [ -s speed ] [ -a acu ] [ -1 line ] 

DESCRIPTION 

Cu_v7 is the original version of CU from UNIX V7, used with 
the DNll and the Bell 801 auto call unit. Cu v7 is obsolete 
and is not supported by the ULTRIX-11 systeifu 

Cu_v7 calls up another UNIX system, a terminal, or possibly 
a non-UNIX system. It manages an interactive conversation 
with possible transfers of text files. Telno is the tele- 
phone nxomber, with minus signs at appropriate places for 
delays. The -t flag is used to dial out to a terminal. 
Speed gives the transmission speed (110, 134, 150, 30o! 
1200); 300 is the default value. . . , , 

The -a and -1 values may be used to specify pathnames for 
the ACU and communications line devices. They can be used 
to override the following built-in choices: 

-a /dev/cuaO -1 /dev/culO 

After making the connection, cu v7 runs as two processes: 
the send process reads the standard input and passes most of 
It to the remote system; the receive process reads from the 
remote system and passes most data to the standard output. 
Lines beginning with '~' have special meanings. 

The send process interprets the following: 

terminate the conversation. 
~EOT terminate the conversation 

~<file send the contents of file to the remote 

system, as though typed at the terminal. 

~' invoke an interactive shell on the local 

system. 

~!cmd ... run the command on the local system (via 

sh -c) . 

~$cmd ... run the command locally and send its out- 
put to the remote system. 

~%take from [to] copy file 'from' (on the remote system) to 

file 'to* on the local system. If 'to' is 
omitted, the 'from' name is used both 
places. 
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~%put from [to] copy file 'from' (on local system) to file 

'to' on remote system. If 'to' is omit- 
ted, the 'from' name is used both places. 



send the line 



'-^ 



• • 



The receive process handles output diversions of the follow- 
ing form: 

~>[>][:]file 

zero or more lines to be written to file 

~> 

In any case, output is diverted (or appended, if '»' used) 
to the file. If ':' is used, the diversion is silent , i.e., 
it is written only to the file. If ':' is omitted, output 
is written both to the file and to the standard output. The 
trailing '->' terminates the diversion. 

The use of ~%put requires stty and cat on the remote side. 
It also requires that the current erase and kill characters 
on the remote system be identical to the current ones on the 
local system. Backslashes are inserted at appropriate 
places. 

The use of ~%take requires the existence of echo and tee on 
the remote system. Also, stty tabs mode is required on the 
remote system if tabs are to be copied without expansion. 

FILES 

/dev/cuaO 
/dev/culO 
/dev/null 

SEE ALSO 

dn(4), tty(4) 

DIAGNOSTICS 

Exit code is zero for normal exit, nonzero (various values) 
otherwise. 

RESTRICTIONS 

The syntax is unique. 
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NAME 

cu_v7m, custat_v7m - call UNIX {V7M version) 

SYNOPSIS 

cu_v7m telno [-t] [-n] [-m] [-s speed] [-a acu] [-1 line] 
custat_v7m 

DESCRIPTION 

Cu v7m is the version of the cu command supplied with the 
ULTRIX-11 VI. software. Cu v7m remains a part of the 
ULTRIX-11 system, but its use is not recommended. Digital 
recommends use of the tip utility in place of cu, refer to 
tip (lc) for details. 

Cu v7m calls up another UNIX system, or possibly a non-UNIX 
system. It manages an interactive conversation with possi- 
ble transfers of text files. Cu v7m establishes the system 
to system connection by calling the remote system via DF02- 
AC or DF03-AC auto call modem, or over a direct link with 
the remote system. Telno is the telephone number, with an 
equal sign at the appropriate place if an intermediate dial 
tone is expected. The -t flag is used to access the remote 
system over a direct link instead of an auto call unit. 
Speed gives the transmission speed (110, 150, 300, 1200, 
2400, 4800, 9600); the default value is 9600 for direct con- 
nects (-t) and 1200 for auto dial connections. 

The -a and -1 values may be used to specify pathnames for 
the ACU and communications line devices. They can be used 
to override the following built-in choices: 

-a /dev/cuaO -1 /dev/culO 

The -n option, where n is a single digit, changes the last 
character of the ACU and communications line to n. It is an 
abbreviation for -a /dev/cuan -1 /dev/culn. 

The -m option is used in conjunction with the -t flag when 
the direct link involves modems. This option forces data 
terminal ready (DTR) to be asserted by the communications 
line device driver. 

After making the connection, cu v7m runs as two processes: 
the send process reads the standard input and passes most of 
it to the remote system; the receive process reads from the 
remote system and passes most data to the standard output. 
Lines beginning with '~' have special meanings, which are 
acted upon only after the receipt of a newline. 
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The send process interprets the following: 

~. terminate the conversation. 

~<file send the contents of file to the remote 

system, as though typed at the terminal. 

~# sends a break (cycles speeds on auto bit 

rate lines). 

~! invoke an interactive shell on the local 

system. 

~!cmd ... run the command on the local system (via 

sh -c) . 

~$cmd . . . run the command locally and send its out- 
put to the remote system. 

~%take from [to] copy file 'from' (on the remote system) to 

file 'to' on the local system. If 'to' is 
omitted, the 'from' name is used both 
places. 

~%put from [to] copy file 'from' (on local system) to file 

'to' on remote system. If 'to' is omit- 
ted, the 'from' name is used both places. 

~: during an output diversion, this toggles 

whether the operation of cu v7m will be 
silent, i.e., whether information received 
from the remote system will be written to 
the standard output. This allows a "pro- 
gress report" during long transfers. 

— ... send the line '~...'. 

Both the send and receive processes handle output diversions 
of the following form: 

~>[>][:]file 

zero or more lines to be written to file 

~> 

In any case, output is diverted (or appended, if '»' used) 
to the file. If ':' is used, the diversion is silent , i.e., 
it is written only to the file. If ':' is omitted, output 
is written both to the file and to the standard output. The 
trailing •~>' terminates the diversion. 

The use of ~%put requires stty and cat on the remote side. 
It also requires that the current erase and kill characters 
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on the remote system be identical to the current ones on the 
local system. Backslashes are inserted at appropriate 
places. 

The use of ~%take requires the existence of echo and tee on 
the remote system. Also, stty tabs mode is required~on the 
remote system if tabs are to be copied without expansion. 

The custat v7m command shows the status of all auto call 
units and communications lines. This enables the users of cu 
to more easily select an available ACU or line. — 

FILES 

/dev/cua[0-7] 

/dev/cul[0-7] 

/dev/null 

/usr/spool/uucp/LCK..cu[al][0-7] - lock files 

/usr/adm/culog - log file 

SEE ALSO 

tty(4) 

ULTRIX-11 System Management Guide, Section 4.8 

DIAGNOSTICS 

Exit code is zero for normal exit, nonzero (various values) 
otherwise. 

RESTRICTIONS 

The syntax is unique. 

A ~%put cannot be aborted by typing the interrupt character, 
~. will stop the transfer and disconnect the line. 
When typing lines that begin with '-' , erase and kill pro- 
cessing do not function properly, i.e., the characters are 
deleted but still remain on the screen. 

The lack of proper flow control causes file transfers at 
speeds of greater than 1200 BPS to be unreliable, depending 
on the amount of activity on the local and remote systems. 



CUT(l) 



CUT(l) 



NAME 



cut - cut out selected fields of each line of a file 



SYNOPSIS 
cut 
cut 



-clist [filel file2 
-flist [-dchar] [-s] 



[filel file2 ...] 



DESCRIPTION 

Use cut to cut out coliomns from a table or fields from each 
line of a file; in data base parlance, it implements the 
projection of a relation. The fields as specified by list 
can be fixed length, i.e., character positions as on a 
punched card (-c option), or the length can vary from line 
to line and be marked with a field delimiter character like 
tab (-f option). Cut can be used as a filter; if no files 
are given, the standard input is used. 

The meanings of the options are: 

list A comma-separated list of integer field numbers (in 
increasing order), with optional - to indicate 
ranges as in the -o option of nroff /troff for page 
ranges; e.g., 1,4,7; 1-3,8; -5,T0 Tshort for 
1-5,10); or 3- (short for third through last 
field). 



-clist 



-flist 



-dchar 



-s 



The list following -c (no space) specifies charac- 
ter positions (e.g., -cl-72 would pass the first 72 
characters of each line). 



The 

to 

ter 



f is a list of fields assxjumed 

the file by a delimiter charac- 

, -fl,7 copies the first and 

Lines with no field delimiters 

will be passed through intact (useful for table 

subheadings), unless -s is specified. 



list following - 
be separated in 
(see -d ); e.g. 
seventh field only. 



The character following -d is the field delimiter 
(-f option only). Default is tab . Space or other 
characters with special meaning to the shell must 
be quoted. 

Suppresses lines with no delimiter characters in 
case of -f option. Unless specified, lines with no 
delimiters will be passed through untouched. 



Either the -c or -f option must be specified. 
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HINTS 

Use qrep (l) to make horizontal 'cuts' (by context) through a 
file, or paste d) to put files together column-wise (i.e., 
horizontallyT! To reorder columns in a table, use cut and 
paste . 

EXAMPLES 

cut -d: -fl,5 /etc/passwd 

mapping of user IDs to names 

name=^who am i | cut -fl -d" "' 

to set name to current login name. 

DIAGNOSTICS 

line too long 

A line can have no more than 511 characters or 
fields. 

bad list for c/f option 

Missing -c or -f option or incorrectly specified 

list. No error occurs if a line has fewer 

fields than the list calls for. 

no fields The list is empty. 

SEE ALSO 

grep(l), paste(l). 
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NAME 

date - print and set the date 

SYNOPSIS 

date [ -u ] [ yymmddhhmm [ .ss ] ] 

DESCRIPTION 

If no argument is given, the current date and time are 
printed. If an argiiment is given, the current date is set. 
yy is the last two digits of the year; the first nun is the 
month number; dd is the day number in the month; hh is the 
hour number (24 hour system); the second mm is the minute 
number; .ss is optional and is the seconds. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The year, month and day 
may be omitted, the current values being the defaults. The 
system operates in GMT. Date takes care of the conversion 
to and from local standard and daylight time. The -u flag 
causes date to set and print the date and time in GMT 
without converting to local time. 

FILES 

/usr/adm/wtmp to record time-setting 

SEE ALSO 

utmp ( 5 ) 

DIAGNOSTICS 

'No permission' if you aren't the super-user and you try to 
change the date; 'bad conversion' if the date set is syntac- 
tically incorrect. 
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NAME 

dc - desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily 
It operates on decimal integers, but one may specify an 
input base, output base, and a number of fractional digits 
to be maintained. The overall structure of dc is a stacking 
(reverse Polish) calculator. If an argument'~Ts given, input 
is taken from that file until its end, then from the stan- 
dard input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A 
number is an unbroken string of the digits 0-9. It 
may be preceded by an underscore _ to input a negative 
number. Numbers may contain decimal points. 

+ - / * % ^ 

The top two values on the stack are added (+), sub- 
tracted (-), multiplied (*), divided (/), remaindered 
(%), or exponentiated ('^). The two entries are popped 
off the stack; the result is pushed on the stack in 
their place. Any fractional part of an exponent is 
ignored. 

sx The top of the stack is popped and stored into a 
register named x, where x may be any character. If 
the s is capitalized, x is treated as a stack and the 
value is pushed on it. 

Ix The value in register x is pushed on the stack. The 
register x is not altered. All registers start with 
zero value. If the 1 is capitalized, register x is 
treated as a stack and its top value is popped onto 
the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value 
remains unchanged. P interprets the top of the stack 
as an ascii string, removes it, and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recur- 
sion level is popped by two. If q is capitalized, the 
top value on the stack is popped and the string execu- 
tion level is popped by that value. 
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X treats the top element of the stack as a character 
string and executes it as a string of dc commands. 

X replaces the number on the top of the stack with its 
scale factor. 

[ ... ] 

puts the bracketed ascii string onto the top of the 
stack. 

<x >x =x 

The top two elements of the stack are popped and com- 
pared. Register x is executed if they obey the stated 
relation. 

V replaces the top element on the stack by its square 
root. Any existing fractional part of the argument is 
taken into account, but otherwise the scale factor is 
ignored. 

! interprets the rest of the line as a UNIX command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the 
niunber radix for further input. I pushes the input 
base on the top of the stack. 

o The top value on the stack is popped and used as the 
number radix for further output. 

O pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used 
as a non-negative scale factor: the appropriate number 
of places are printed on output, and maintained during 
multiplication, division, and exponentiation. The 
interaction of scale factor, input base, and output 
base will be reasonable if all are changed together. 

z The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its 
length. 

? A line of input is taken from the input source (usu- 
ally the terminal) and executed. 

; : are used ^y be for array operations. 
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An example that prints the first ten values of n! is 

[ lal+dsa*plalO>y]sy 

Osal 

lyx 

SEE ALSO 

bed), which is a preprocessor for dc providing infix nota- 
tion and a C-like syntax which implements functions and rea- 
sonable control structures for programs. 

DIAGNOSTICS 

'x is unimplemented' where x is an octal number. 

'stack empty' for not enough elements on the stack to do 

what was asked. 

'Out of space' when the free list is exhausted (too many 

digits) . 

'Out of headers' for too many numbers being kept around. 

'Out of pushdown' for too many items on the stack. 

'Nesting Depth' for too many levels of nested execution. 
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NAME 

dcheck - file system directory consistency check 

SYNOPSIS 

dcheck [ -i numbers ] filesystem 

DESCRIPTION 

Dcheck reads the directories in a file system and compares 
the link-count in each i-node with the number of directory 
entries by which it is referenced. If the file system is 
not specified, a set of default file systems is checked. 

The -i flag is followed by a list of i-numbers; when one of 
those i-numbers turns up in a directory, the number, the i- 
niamber of the directory, and the name of the entry are 
reported. 

The program is fastest if the raw version of the special 
file is used, since the i-list is read in large chunks. 

FILES 

There are no default file systems, they must be specified. 

SEE ALSO 

icheck(l), filsys(5), clri(l), ncheck(l), fsck(l) 

DIAGNOSTICS 

When a file turns up for which the link-count and the number 
of directory entries disagree, the relevant facts are 
reported. Allocated files which have link-count and no 
entries are also listed. The only dangerous situation 
occurs when there are more entries than links; if entries 
are removed, so the link-count drops to 0, the remaining 
entries point to thin air. They should be removed. When 
there are more links than entries, or there is an allocated 
file with neither links nor entries, some disk space may be 
lost but the situation will not degenerate. 

RESTRICTIONS 

Since dcheck is inherently two-pass in nature, extraneous 
diagnostics may be produced if applied to active file sys- 
tems. 

For the most part icheck (1) has been superseded by fsck 
(1). ~ 
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NAME 

dcopy - copy file systems for optimal access time 

SYNOPSIS 

/etc/dcopy [ options ] inputfs outputfs 

DESCRIPTION 

Dcopy copies file system inputfs to outputfs . Inputfs is 
the existing file system; outputfs is an appropriately sized 
file system, to hold the reorganized result. Inputfs must 
be the raw device and outputfs must be the block device. 
Dcopy must be run on unmounted file systems (in the case of 
the root file system, copy to a new pack). With no argu- 
ments, dcopy copies files from inputfs compressing direc- 
tories by removing vacant entries, and spacing consecutive 
blocks in a file by the optimal rotational gap. 

Options: 

-sX supply device information for creating an optimal 
organization of blocks in a file. The forms of X 
are the same as the -s option of fsck (lM) . Dcopy 
will attempt to use the values from the output 
filesystem if the parameters given in this option 
are not reasonable. 

-an place the files not accessed in n days after the 
free blocks of the destination file system 
(default for n is 7). If no a is specified then 
no movement occurs. 

-d leave order of directory entries as is (default is 
to move sub-directories to the beginning of direc- 
tories) . 

-V currently reports how many files were processed, 
and how big the source and destination freelists 
are. 

-n do not ask before copying file systems. Default 
is to ask for confirmation before proceeding. 
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-f fsize[ : isize] 



specify the output fs file system and inode list 
sizes (in blocks) . If not given, the values from 
the output fs are used. Dcopy catches interrupts 
and quits and reports on its progress. To ter- 
minate dcopy , send a quit signal and dcopy will no 
longer catch interrupts or quits. Dcopy also 
attempts to modify its command line arguments so 
its progress can be monitored with ps(l) . 



SEE 



ALSO 
fsck(lM) 



mkfs(lM), ps(l). 
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NAME 

dd - convert and copy a file 

SYNOPSIS 

dd [option=value] ... 

DESCRIPTION 

Dd copies the specified input file to the specified output 
with possible conversions. The standard input and output 
are used by default. The input and output block size may be 
specified to take advantage of raw physical I/O. 

option values 

if= input file name; standard input is default 

of= output file name; standard output is default 

ibs=n input block size n bytes (default 512) 
obs=n output block size (default 512) 
bs=n set both input and output block size, 

superseding ibs and obs ; also, if no conver- 
sion is specified, it is particularly effi- 
cient since no copy need be done 
cbs=n conversion buffer size 

skip=n skip n input records before starting copy 
files=n copy n files from (tape) input 
seek=n seek n records from beginning of output file 

before copying 
count=n copy only n input records 
conv=ascii convert EBCDIC to ASCII 

ebcdic convert ASCII to EBCDIC 

ibm slightly different map of ASCII to EBCDIC 

lease map alphabet ics to lower case 

ucase map alphabet ics to upper case 

swab swap every pair of bytes 

noerror do not stop processing on an error 

sync pad every input record to ibs 

... , ... several comma-separated conversions 

Where sizes are specified, a number of bytes is expected. A 
number may end with k, b or w to specify multiplication by 
1024, 512, or 2 respectively; a pair of numbers may be 
separated by x to indicate a product. 

Cbs is used only if ascii or ebcdic conversion is specified. 
In the former case cbs characters are placed into the 
conversion buffer, converted to ASCII, and trailing blanks 
trimmed and new-line added before sending the line to the 
output. In the latter case ASCII characters are read into 
the conversion buffer, converted to EBCDIC, and blanks added 
to make up an output record of size cbs. 

After completion, dd reports the number of whole and partial 
input and output blocks. 
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For example, to read an EBCDIC tape blocked ten 80-byte 
EBCDIC card images per record into the ASCII file x: 

dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=ascii , lease 

Note the use of raw magtape. Dd is especially suited to I/O 
on the raw physical devices because it allows reading and 
writing in arbitrary record sizes. 

To skip over a file before copying from magnetic tape do 

(dd of=/dev/null; dd of=x) </dev/rmtO 

SEE ALSO 

cp{l), tr(l) 

DIAGNOSTICS 

f+p records in(out): numbers of full and partial records 
read(written) 

RESTRICTIONS 

The ASCII/EBCDIC conversion tables are taken from the 256 
character standard in the CACM Nov, 1968. The 'ibm' conver- 
sion, while less blessed as a standard, corresponds better 
to certain IBM print train conventions. There is no univer- 
sal solution. 

Newlines are inserted only on conversion to ASCII; padding 
is done only on conversion to EBCDIC. These should be 
separate options. 

CAUTION 

Image copying disks using dd requires careful selection of 
the block size (bs, ibs, obs). Using the default block size 
of 512 bytes (lb) will always work, however this is not very 
efficient. In most cases the optimum block size is the 
number of 512 byte sectors per track. For example: to copy 
an RL02 disk to another RL02 disk use 'bs=20b', or to copy 
an RP06 to an RM03 use ' ibs=22b obs=32b' . If the size of 
the input disk is larger that the size of the output disk a 
portion of the last record will not be transferred. An disk 
image copy using dd will always terminate with the message 
'No such device or address' , this indicates that the end of 
the disk has been reached. 
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NAME 



delta - make a delta (change) to an SCCS file 

SYNOPSIS 

delta [-rSID] [-s] [-n] [-glist] [-m[inrlist] ] [-y[comment] ] 
[-p] files 



DESCRIPTION 

Dgj-ta is used to permanently introduce into the named SCCS 
changes that were made to the file retrieved by qet(l) 
g- f ile , or generated file). 



fTTi" 
(called 



the 



pelta makes a delta to each named SCCS file. If a directory 
IS named, delta behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files 
(last component of the path name does not begin with s.) and 
unreadable files are silently ignored. If a name of - is 
given, the standard input is read (see WARNINGS ) ; each line 
of the standard input is taken to be the name of an SCCS 
file to be processed. 



Delta may issue prompts on the standard output depending 
upon certain keyletters specified and flags (see admin(l)) 
that may be present in the SCCS file (see -m" 
keyletters below) . 



and -y 



Keyletter arguments apply independently to each named file. 



-rSID 



Uniquely identifies which delta is to be 
made to the SCCS file. The use of this 
keyletter is necessary only if two or 
more outstanding get s for editing (get 
-e) on the same SCCS file were done by 
the same person (login name). The SID 
value specified with the -r keyletter 
can be either the SID specified on the 
get command line or the SID to be made 
as reported by the c[et command (see 
get (l) ) . A diagnostic results if the 
specified SID is ambiguous, or, if 
necessary and omitted on the command 
line. 



-s 



-n 



Suppresses the issue, on the standard 
output, of the created delta's SID, as 
well as the number of lines inserted, 
deleted and unchanged in the SCCS file. 

Specifies retention of the edited g- f ile 
(normally removed at completion of delta 
processing) . 
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-g list Specifies a list (see get (l) for the 
definition of list ) of deltas which are 
to be ignored when the file is accessed 
at the change level (SID) created by 
this delta. 

-m[ mrlist ] If the SCCS file has the v flag set (see 
admin (l) ) then a Modification Request 
(MR) number must be supplied as the rea- 
son for creating the new delta. 

If -m is not used and the standard input 
is a terminal, the prompt MRs? is issued 
on the standard output before the stan- 
dard input is read; if the standard 
input is not a terminal, no prompt is 
issued. The MRs? prompt always precedes 
the comments? prompt (see -y keyletter). 

MRs in a list are separated by blanks 
and/or tab characters. An unescaped 
new-line character terminates the MR 
list. 

Note that if the v flag has a value (see 
admin (l) ) , it is taken to be the name of 
a program (or shell procedure) which 
will validate the correctness of the MR 
numbers. If a non-zero exit status is 
returned from MR number validation pro- 
gram, delta terminates (it is assumed 
that the MR numbers were not all valid). 

-y[ comment ] Arbitrary text used to describe the rea- 
son for making the delta. A null string 
is considered a valid comment . 

If -y is not specified and the standard 
input is a terminal, the prompt com- 
ments? is issued on the standard output 
before the standard input is read; if 
the standard input is not a terminal, no 
prompt is issued. An unescaped new-line 
character terminates the comment text. 

-p Causes delta to print (on the standard 

output) the SCCS file differences before 
and after the delta is applied in a 
diff (l) format. 

FILES 

All files of the form ?-file are explained in the Source 
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Code Control System User 's Guide . The naming convention for 
these files is also described there. 



g-f ile 
p-f ile 
q-file 
x-file 

z-f ile 
d-file 
/usr/bin/bdif f 



Existed 

removed 

Existed 

exist a 

Created 

removed 

Created 

renamed 

delta. 

Created 

removed 

Created 

removed 

Program 

'gotten 



before the execution of delta ; 
after completion of delta , 
before the execution of delta ; may 
fter completion of delta . 

during the execution of delta ; 
after completion of delta. 

during the execution of delta ; 

to sees file after completion of 



during the execution 

during the execution of 

during the execution 



of delta; 
delta, 
of delta; 



after completion of delta, 
to compute differences between the 
' file and the g- f ile . 



WARNINGS 

Lines beginning with an SOH ASCII character (binary 001) 
cannot be placed in the SCCS file unless the SOH is escaped. 
This character has special meaning to SCCS (see sccsf ile (5) ) 

error. 



and will cause an 



L get 
files, 
amount 
should 



many SCCS 
should be 
of data, 
be used. 



delta 



files, followed by a 
avoided when the get 
Instead, multiple get / delta 



of those 

generates a large 

sequences 



If the standard input (-) is specified on the delta command 
line, the -m (if necessary) and -y keyletters must also be 
present. Omission of these keyletters causes an error to 
occur. 



SEE 



ALSO 
admin(l), bdiff(l), get(l), help(l), prs(l), sccsfile(5) 
Source Code Control System User 's Guide by L. E. Bonanni 
C. A. Salemi. 



and 



DIAGNOSTICS 

Use help (l) 



for explanations. 
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NAME 

deroff - remove nroff, troff, tbl and eqn constructs 

SYNOPSIS 

deroff C -w 3 file ... 

DESCRIPTION 

Deroff reads each file in sequence and removes all nroff and 
trof f command lines, backslash constructions, macro defini- 
tions, eqn constructs (between ' .EQ' and ' .EN' lines or 
between delimiters), and table descriptions and writes the 
remainder on the standard output. Deroff follows chains of 
included files ('.so' and '.nx' commands); if a file has 
already been included, a '.so' is ignored and a '.nx' ter- 
minates execution. If no input file is given, deroff reads 
from the standard input file. 

If the -w flag is given, the output is a word list, one 
'word' (string of letters, digits, and apostrophes, begin- 
ning with a letter; apostrophes are removed) per line, and 
all other characters ignored. Otherwise, the output follows 
the original, with the deletions mentioned above. 

SEE ALSO 

troff(l), eqn(l), tbl(l) 

RESTRICTIONS 

Deroff is not a complete trof f interpreter, so it can be 
confused by subtle constructs. Most errors result in too 
much rather than too little output. 
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NAME 

df - disk free 

SYNOPSIS 

df [ f ilesystem ] ... 

DESCRIPTION 

Df prints out the number of free blocks available on the 
f ilesystems . If no file system is specified, the free space 
on all of the normally mounted file systems is printed. 

FILES 

Default file system names obtained from the / etc / fstab file. 

SEE ALSO 

icheck(l), fsck(l), fstab(5) 
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NAME 



diff - differential file comparator 



SYNOPSIS 

diff [ -efbh ] filel file2 

DESCRIPTION 

Diff tells what lines must be changed in two files to bring 
them into agreement. If filel ( f ile2 ) is '-', the standard 
input is used. If filel ( f ile2 ) is a directory, then a file 
in that directory whose file-name is the same as the file- 
name of f ile2 ( filel ) is used. The normal output contains 
lines of these forms: 

nl a n3,n4 
nl,n2 d n3 
nl,n2 c n3,n4 



These lines resemble ed commands to convert filel into 
f ile2 . The numbers after the letters pertain to f ile2 . In 
fact, by exchanging 'a' for 'd' and reading backward one may 
ascertain equally how to convert f ile2 into filel . As in 
ed , identical pairs where nl = n2 or n3 = M are abbreviated 
as a single nxomber. 



Following each of these lines come all the 
affected in the first file flagged by 
lines that are affected in the second file flagged by 



lines that are 
•<• , then all the 



The -b option causes trailing blanks (spaces and tabs) to be 
ignored and other strings of blanks to compare equal. 



The -e option produces a script of 

the editor ed, which will recreate 

option produces a similar script, not 
opposite order. In connection 



a, c and d 
file2 from 



commands for 
filel . The -f 
the 



useful with ed, in 
with -e, the following shell 
program may help maintain multiple versions of a file. Only 
an ancestral file ($1) and a chain of version-to-version ed 
scripts ($2, $3,...) made by diff need be on hand. A 'latest 
version' appears on the standard output. 



(shift; cat $*; echo 'l,$p') 1 ed - $1 

Except in rare circumstances, diff finds a 
cient set of file differences. 



smallest suffi- 



Option -h does a fast, half-hearted job. It works only when 
changed stretches are short and well separated, but does 
work on files of unlimited length. Options -e and -f are 
unavailable with -h. 
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FILES 

/tmp/d????? 
/usr/lib/diffh for -h 

SEE ALSO 

cmp(l), commd), ed{l) 

DIAGNOSTICS 

Exit status is for no differences, 1 for some, 2 for trou- 
ble. 

RESTRICTIONS 

Editing scripts produced under the -e or -f option are naive 
about creating lines consisting of a single '.'. 
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NAME 

diff3 - 3-way differential file comparison 

SYNOPSIS 

diff3 [ -ex3 ] filel file2 file3 

DESCRIPTION 

Dif f 3 compares three versions of a file, and publishes 
disagreeing ranges of text flagged with these codes: 

==== all three files differ 

====1 filel is different 

====2 f ile2 is different 

====3 f ile3 is different 

The type of change suffered in converting a given range of a 
given file to some other is indicated in one of these ways: 

f^ : nl a Text is to be appended after line number nl 

in file f, where £ = 1, 2, or 3. 

f^ : nl , n2 c Text is to be changed in the range line nl 

to line n2. If nl = n2, the range may be 
abbreviated to nl. 

The original contents of the range follows immediately after 
a c indication. When the contents of two files are identi- 
cal, the contents of the lower-numbered file is suppressed. 

Under the -e option, dif f 3 publishes a script for the editor 
ed that will incorporate into filel all changes between 
f ile2 and f ile3 , i.e. the changes that normally would be 
flagged ==== and ====3. Option -x (-3) produces a script to 
incorporate only changes flagged ==== (====3). The follow- 
ing command will apply the resulting script to 'filel'. 

(cat script; echo 'l,$p') I ed - filel 

FILES 

/tmp/d3????? 
/usr/lib/diff3 

SEE ALSO 

diff(l) 

RESTRICTIONS 

Text lines that consist of a single '.' will defeat -e. 
Files longer than 64K bytes won't work. 
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NAME 

du - summarize disk usage 

SYNOPSIS 

du [ -s ] [ -a ] [ name ... ] 

DESCRIPTION 

Du gives the number of blocks contained in all files and 
Trecursively) directories within each specified directory or 
file name . If name is missing, '.' is used. 

The optional argument -s causes only the grand total to be 
given. The optional argument -a causes an entry to be gen- 
erated for each file. Absence of either causes an entry to 
be generated for each directory only. 

A file which has two links to it is only counted once. 

RESTRICTIONS 

Non-directories given as arguments (not under -a option) are 
not listed. 

If there are too many distinct linked files, du counts the 
excess files multiply. 
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NAME 

dump - incremental file system dump 

SYNOPSIS 

dump [ key [ argxament ... ] filesystem ] 

DESCRIPTION 

Dump copies to the dump media, usually magtape, all files 
changed after a certain date in the filesystem . The key 
specifies the date and other options about the dump. Key 
consists of characters from the set 0123456789fusdmy. 

Before beginning the the dump startup confirmation is 
requested. This helps prevent accidental overwriting of 
file systems due to improper dump file specifications. 

f Place the dump on the next argument file instead of the 
tape. 

u If the dump completes successfully, write the date of 
the beginning of the dump on file Vetc/ddate' . This 
file records a separate date for each filesystem and 
each dump level. 

0-9 This niomber is the 'dump level'. All files modified 
since the last date stored in the file '/etc/ddate' for 
the same filesystem at lesser levels will be dumped. 
If no date is determined by the level, the beginning of 
time is assumed; thus the option causes the entire 
filesystem to be dumped. 

s The size of the dump tape is specified in feet. The 
number of feet is taken from the next argument . When 
the specified size is reached, the dump will wait for 
reels to be changed. The default size is 2300 feet. 

d The density of the tape, expressed in BPI, is taken 
from the next argument . This is used in calculating the 
amount of tape used per write. The default is 1600. 

m Micro/pdp-11, dump to RX50 diskettes instead of tape. 
The f^ option must also be specified when m is used. 
For example: duunp Oumf /dev/rrx2 /dev/rrdO 

y Suppress the start of dump confirmation query, allows 
for non-interactive use of dump . 

If no arguments are given, the key is assumed to be 9u and a 
default file system is dumped to the default tape. 
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Now a short suggestion on how perform dumps. Start with a 
full level dump 

dump Ou 

Next, periodic level 9 dumps should be made on an exponen- 
tial progression of tapes. (Sometimes called Tower of Hanoi 
-12131214... tape 1 used every other time, tape 2 
used every fourth, tape 3 used every eighth, etc.) 

dump 9u 

When the level 9 incremental approaches a full tape (about 
78000 blocks at 1600 BPI blocked 20), a level 1 dump should 
be made. 

dump lu 

After this, the exponential series should progress as unin- 
terrupted. These level 9 dumps are based on the level 1 
dump which is based on the level full dump. This progres- 
sion of levels of dump can be carried as far as desired. 

FILES 

/dev/null - default file system to be dumped 

/dev/rhtO - default dump device 

/etc/ddate - record dump dates of f ilesystem/level. 

SEE ALSO 

restor(l), dump(5), dumpdir(l) 

ULTRIX-11 System Management Guide, Sections 4.2 and 5.1.4 

DIAGNOSTICS 

If the dump requires more than one tape, it will ask you to 
change tapes. Reply with a new-line when this has been 
done. 

Unless the y option is specified dump asks for confirmation, 
as follows: 

Last chance before writing on /dev/r??## 
Continue <y or n> ? 

A read error on the file system will result in an error mes- 
sage, but the dump will continue. 

Unrecoverable write errors on the dump device cause the dump 
of the current volxirae to be aborted. The dump program will 
ask if the current volume is to be rewritten. Answer yes to 
continue the dump with the current volume or no to abort the 
entire dump. 
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RESTRICTIONS 

Sizes are based on 1600 BPI blocked tape. The raw magtape 
device has to be used to approach these densities. 
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NAME 

duunpdir - print the names of files on a dump tape 

SYNOPSIS 

dumpdir [ f filename ] 

DESCRIPTION 

Dumpdir is used to read magtapes diimped with the dump com- 
mand and list the names and inode numbers of all the files 
and directories on the tape. 

The f option causes filename as the name of the tape instead 
of the default. 

FILES 

/dev/rhtO - default tape 
rst* 

SEE ALSO 

dump(5), dump(l), restor(l) 

DIAGNOSTICS 

If the dxomp extends over more than one tape, it may ask you 
to change tapes. Reply with a new-line when the next tape 
has been mounted. 

RESTRICTIONS 

There is redundant information on the tape that could be 
used in case of tape reading problems. Unfortunately, dump- 
dir doesn't use it. 
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NAME 



echo - echo arguments 



SYNOPSIS 

echo [ -n ] [ arg ] 



DESCRIPTION 

Echo writes its argioments separated by blanks and 
By a newline on the standard output. If the 
used, no newline is added to the output. 



terminated 
flag -n 



IS 



Echo is useful for producing diagnostics in shell programs 
and for writing constant data on pipes. To send diagnostics 
to the standard error file, do 'echo ... 1>&2'. 
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NAME 

ed - text editor 

SYNOPSIS 

ed [ - ] [ name ] 

red [ - ] [ name ] 

DESCRIPTION 

Ed is the standard text editor. 

If a name argument is given, ed simulates an e command (see 
belowl on the named file; that is to say, the file is read 
into ed's buffer so that it can be edited. The optional - 
suppresses the printing of character counts by e, r, and w 
commands, of diagnostics from e and g commands, and of the ! 
prompt after a ! shell command . 

Ed operates on a copy of any file it is editing; changes 

made in the copy have no effect on the file until a w 

(write) command is given. The copy of the text being edited 

resides in a temporary file called the buffer . 

Red is a restricted version of ed. It will only allow edit- 
ing of files in the current directory. It prohibits execut- 
ing shell commands via ! shell command . Attempts to bypass 
these restrictions result in an error message (restricted 
shell ). 

Commands to ed have a simple and regular structure: zero or 
more addresses followed by a single character command , pos- 
sibly followed by parameters to the command. These 
addresses specify one or more lines in the buffer. Missing 
addresses are supplied by default. 

In general, only one command may appear on a line. Certain 
commands allow the addition of text to the buffer. While ed 
is accepting text, it is said to be in input mode . In this 
mode, no commands are recognized; all input is merely col- 
lected. Input mode is left by typing a period '.' alone at 
the beginning of a line. 

Ed supports a limited form of regular expression notation. 
A regular expression specifies a set of strings of charac- 
ters. A member of this set of strings is said to be matched 
by the regular expression. In the following specification 
for regular expressions the word 'character' means any char- 
acter but newline. 

The regular expressions allowed by ed are constructed as 
follows: 
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The following one-character regular expressions match a sin- 
gle character: 

1.1 An ordinary character ( not one of those discussed in 
1,2 below) is a one-character regular expression that 
matches itself. 

1.2 A backslash (\) followed by any special character is 
a one-character regular expression that matches the 
special character itself. The special characters 
are: 

a. .,*,[, and \ (period, asterisk, left square 
bracket, and backslash, respectively), which 
are always special, except when they appear 
within square brackets ([]; see 1.4 below). 

b. ^ (caret or circumflex), which is special at 
the beginning of an entire regular expression 
(see 3.1 and 3.2 below) , or when it immediately 
follows the left of a pair of square brackets 
( [ ] ) (see 1.4 below) . 

c. $ (currency symbol), which is special at the 
end of an entire regular expression (see 3.2 
below) . 

d. The character used to bound (i.e., delimit) an 
entire regular expression, which is special for 
that regular expression (for example, see how 
slash (/) is used in the 3 command, Iselow.) 

1.3 A period (.) is a one-character regular expression 
that matches any character except new-line. 

1.4 A non-empty string of characters enclosed in square 
brackets ([]) is a one-character regular expression 
that matches any one character in that string. If, 
however, the first character of the string is a cir- 
cumflex (^), the one-character regular expression 
matches any character except newline and the remain- 
ing characters in the string. The '^ has this special 
meaning only if it occurs first in the string. The 
minus (-) may be used to indicate a range of consecu- 
tive ASCII characters; for example, [0-9] is 
equivalent to [0123456789]. The - loses this special 
meaning if it occurs first (after an initial ^, if 
any) or last in the string. The right square bracket 
(]) does not terminate such a string when it is the 
first character within it (after an initial , if 
any); e.g., []a-f] matches either a right square 
bracket (]) or one of the letters a through f 
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inclusive. The four characters listed in 1.2. a above 
stand for themselves within such a string of charac- 
ters. 

The following rules may be used to construct regular expres- 
sions from one-character regular expressions: 

2.1 A one-character regular expression is a regular 
expression that matches whatever the one-character 
regular expression matches. 

2.2 A one-character regular expression followed by an 
asterisk (*) is a regular expression that matches 
zero or more occurrences of the one-character regular 
expression. If there is any choice, the longest 
leftmost string that permits a match is chosen. 

2.3 A one-character regular expression followed by \{m\}, 
\{m,\}/ or \{m,n\} is a regular expression that 
matches a range of occurrences of the one-character 
regular expression. The values of m and n must be 
non-negative integers less than 256; \{m\} matches 
exactly m occurrences; \{m,\} matches at least m 
occurrences; \{m,n\} matches any number of 
occurrences between m and n inclusive. Whenever a 
choice exists, the regular expression matches as many 
occurrences as possible. 

2.4 The concatenation of regular expressions is a regular 
expression that matches the concatenation of the 
strings matched by each component of the regular 
expression. 

2.5 A regular expression enclosed between the character 
sequences \{ and \) is a regular expression that 
matches whatever the unadorned regular expression 
matches. 

2.6 The expression \n matches the same string of charac- 
ters as was matched by an expression enclosed between 
\( and \) earlier in the same regular expression. 
Here n is a digit; the sub-expression specified is 
that beginning with the n-th occurrence of \{ count- 
ing from the left. For example, the expression 
\(.*\)\1$ matches a line consisting of two repeated 
appearances of the same string. 

Finally, an entire regular expression may be constrained to 
match only an initial segment or final segment of a line (or 
both) : 

3.1 A circumflex i"^) at the beginning of an entire 
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regular expression constrains that regular expression 
to match an initial segment of a line. 

3.2 A currency symbol ($) at the end of an entire regular 
expression constrains that regular expression to 
match a final segment of a line. 

Regular expressions are used in addresses to specify lines 
and in one command (see s below) to specify a portion of a 
line which is to be replaced. If it is desired to use one 
of the regular expression metacharacters as an ordinary 
character, that character may be preceded by '\'. This also 
applies to the character bounding the regular expression 
(often '/') and to '\' itself. 

The construction entire regular express ion $ constrains the 
entire regular expression to match the entire line. 

The null regular expression (e.g., //) is equivalent to the 
last regular expression encountered. See also the last 
paragraph before FILES below. 

To understand addressing in ed it is necessary to know that 
at any time there is a current line . Generally speaking, the 
current line is the last line affected by a command; how- 
ever, the exact effect on the current line is discussed 
under the description of the command. Addresses are con- 
structed as follows. 

1. The character '.' addresses the current line. 

2. The character '$' addresses the last line of the 
buffer. 

3. A decimal number n addresses the n-th line of the 
buffer. 

4. 'x addresses the line marked with the name x, which 
must be a lowercase letter. Lines are marked with the 
k command described below. 

5. A regular expression enclosed in slashes '/' addresses 
the line found by searching forward from the current 
line and stopping at the first line containing a string 
that matches the regular expression. If necessary the 
search wraps around to the beginning of the buffer. 
See also the last paragraph before FILES below. 

6. A regular expression enclosed in queries '?' addresses 
the line found by searching backward from the current 
line and stopping at the first line containing a string 
that matches the regular expression. If necessary the 
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search wraps around to the end of the buffer. See also 
the last paragraph before FILES below. 

7. An address followed by a plus sign '+' or a minus sign 
'-' followed by a decimal number specifies that address 
plus (respectively minus) the indicated number of 
lines. The plus sign may be omitted. 

8. If an address begins with '+' or '-' the addition or 
subtraction is taken with respect to the current line; 
e.g. '-5' is understood to mean '.-5'. 

9. If an address ends with '+' or '-', then 1 is added to 
or subtracted from the address, respectively. As a 
consequence of this rule and of rule 8 immediately 
above, the address - refers to the line preceding the 
current line. (To maintain compatibility with earlier 
versions of the editor, the character in addresses is 
entirely equivalent to -.) Moreover, trailing '+' and 
'-' characters have a cumulative effect, so ' — ' refers 
to the current line less 2. 

10. For convenience, a comma (,) stands for the address 
pair 1,$, while a semicolon (;) stands for the pair 

Commands may require zero, one, or two addresses. Commands 

which require no addresses regard the presence of an address 

as an error. Commands which accept one or two addresses 

assume default addresses when insufficient ones are given. 

If more addresses are given than such a command requires, 
the last one or two (depending on what is accepted) are 
used. 



Addresses are separated from each other typically by a comma 
' , ' . They may also be separated by a semicolon ' ; ' . In 
this case the current line '.' is set to the previous 
address before the next address is interpreted. This 
feature can be used to determine the starting line for for- 
ward and backward searches ( '/', '?'). The second address 
of any two-address sequence must correspond to a line fol- 
lowing the line corresponding to the first address. 

In the following list of ed commands, the default addresses 
are shown in parentheses. The parentheses are not part of 
the address, but are used to show that the given addresses 
are the default. 

It is generally illegal for more than one command to appear 
on a line. However, any command (except e, f_, r, or w) may 
be suffixed by 1, n or p, in which case the current line is 
either listed, numbered or printed, respectively, as 
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discussed below under the 1, n and £ commands. 



{.)a 
<text> 



a 

The append command reads the given text and appends it 
after the addressed line. '.' is left on the last line 
input, if there were any, otherwise at the addressed 
line. Address '0' is legal for this command; text is 
placed at the beginning of the buffer. See also the 
last paragraph before FILES below. 

( . , . )c 
<text> 

• 

The change command deletes the addressed lines, then 
accepts input text which replaces these lines. '.' is 
left at the last line input; if there were none, it is 
left at the line preceding the deleted lines. 

(.,.)d 

The delete command deletes the addressed lines from the 
buffer. The line originally after the last line 
deleted becomes the current line; if the lines deleted 
were originally at the end, the new last line becomes 
the current line. 



e filename 

The edit command causes 
buffer to be deleted, 
read in; . is set to the 
no 
name 



the 
and 

last 
'filename' is given, the 
, if any, is used (see the 



entire contents of the 
then the named file to be 
line of the buffer. If 
currently-remembered file 
f command) . The number 



of characters read is typed; 'filename' is remembered 
for possible use as a default file name in subsequent 
e, r, and w commands. If 'filename' is replaced by 
the rest of the line is taken to be 
command whose output is to be read, 
mand is not remembered as the current 
also DIAGNOSTICS below. 



a shell (shUi) 
Such a shell corn- 
file name. See 



E filename 

This command is the same as e, except that no diagnos- 
tic results when no w has been given since the last 
buffer alteration. 

f filename 

The filename command prints the currently remembered 
file name. If 'filename' is given, the currently 
remembered file name is changed to 'filename'. 



(l,$)g/regular expression/command list 
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In the global command, the first step is to mark every 
line which matches the given regular expression. Then 
for every such line, the given command list is executed 
with .; initially set to that line. A single command 
or the first of multiple commands appears on the same 
line with the global command. All lines of a multi- 
line list except the last line must be ended with 'X'. 
A, i, and c commands and associated input are permit- 
ted; the '.' terminating input mode may be omitted if 
It would be on the last line of the command list. The 
a, G, V, and V commands are not permitted in the com- 
mand list. See also RESTRICTIONS and the last para- 
graph before FILES belowT 

(1,$)G/ regular expression / 

In the interactive Global command, the first step is to 
mark every line that matches the given regular expres- 
sion. Then, for every such line, that line is printed, 
. is changed to that line, and any one command (other 
than one of the a, c, i, ^, G, v, and V commands) may 
be input and is executed. After the execution of that 
command, the next marked line is printed, and so on; a 
new-line acts as a null command; an '&' causes the re- 
execution of the most recent command executed within 
the current invocation of G. Note that the commands 
input as part of the execution of the G command may 
address and affect any lines in the buffer. The G com- 
mand can be terminated by an interrupt signal TaSCII 
DEL or BREAK). 

h The help command gives a short error message that 
explains the reason for the most recent ? diagnostic. 

H The Help command causes ed to enter a mode in which 
error messages are printed for all subsequent ? diag- 
nostics. It will also explain the previous ? if there 
was one. The H command alternately turns this mode on 
and off; it is initially off. 



(.)i 
<text> 



This command inserts the given text before the 
addressed line. '.' is left at the last line input, 
or. If there were none, at the line before the 
addressed line. This command differs from the a com- 
mand only in the placement of the text. Address ~0 is 
not legal for this command. The maximum number of 
characters that may be entered from a terminal is 256 
per line (including the newline character). 



ED(1) 



ED(1) 



{.,.+l)j 

This command joins the addressed lines into a 
line; intermediate newlines simply disappear. 
left at the resulting line. 



single 
• .' is 



( . )kx 

The mark command marks the addressed line with name x, 
which must be a lowercase letter. The address 'x then 
addresses this line; '.' is unchanged. 

(.,.)1 

The list command prints the addressed lines in an unam- 
biguous way: non-graphic characters are printed in 
two-digit octal, and long lines are folded. The 1^ com- 
mand may be placed on the same line after any non-i/o 
command. 

( . , . ) ma 

The move command repositions the addressed line(s) 
after the line addressed by a. Address is legal for 
a and causes the addressed line(s) to be moved to the 
beginning of the file; it is an error if address a 
falls within the range of moved lines; ' . ' is left at 
the last line moved. 

(. , .)n 

The number command prints the addressed lines, preced- 
ing each line by its line number and a tab character; 
'.' is left at the last line printed. The number com- 
mand may placed on the same line after any non-i/o com- 
mand. 

(. ,.)p 

The print command prints the addressed lines. '.' is 
left at the last line printed. The p command may be 
placed on the same line after any non-i/o command. 



The editor will prompt with an asterisk (*) for all 
subsequent commands. The P command alternately turns 
this mode on and off; it is Initially off. 



q The quit command causes ed to exit. No automatic write 
of a file is done. 

Q This command is the same as g, except that no diagnos- 
tic results when no w has been given since the last 
buffer alteration. 

($)r filename 

The read command reads in the given file after the 
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addressed line. If no 'filename' is given, the remem- 
bered file name, if any, is used (see e and f com- 
mands). The file name is remembered Tf there was no 
remembered file name already. Address is legal for r 
and causes the file to be read at the beginning of the 
buffer. If the read is successful, the number of char- 
acters read is typed. '.' is left at the last line 
read in from the file. If 'filename' is replaced by !, 
the rest of the line is taken to be a shell (sh(l)) 
command whose output is to be read. For example, "$r 
Us" appends current directory to the end of the file 
being edited. Such a shell command is not remembered 
as the current file name. 

( .1,. )s/regular expression/replacement/ 
or, 

{ .,. )s/regular express ion/replacement/g 

The substitute command searches each addressed line for 
an occurrence of the specified regular expression. On 
each line in which a match is found, all matched 
strings are replaced by the replacement specified, if 
the global replacement indicator 'g' appears after the 
command. If the global indicator does not appear, only 
the first occurrence of the matched string is replaced. 
It is an error for the substitution to fail on all 
addressed lines. Any character other than space or 
new-line may be used instead of '/' to delimit the reg- 
ular expression and the replacement. '.' is left at 
the last line substituted. See also the last paragraph 
before FILES below. 

An ampersand '&' appearing in the replacement is 
replaced by the string matching the regular expression. 
The special meaning of '&' in this context may be 
suppressed by preceding it by '\'. The characters '\n' 
where n is a digit, are replaced by the text matched by 
the n-th regular subexpression enclosed between '\(' 
and '\)'. When nested, parenthesized subexpressions 
are present, n is determined by counting occurrences of 
'\(' starting from the left. 

Lines may be split by substituting new-line characters 
into them. The new-line in the replacement string must 
be escaped by preceding it by 'X'. Such substitution 
cannot be done as part of a g, G, v, or V command list. 

( . , . ) t a 

This command acts just like the m command, except that 
a copy of the addressed lines is placed after address a 
(which may be 0). '.'is left on the last line of the 
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copy. 

u The undo command nullifies the effect of the most 

recent command that modified anything in the buffer, 

namely the most recent a, c, d, £, i, 2, m, r, s, t, v, 
G, or V command. 

(l,$)v/ regular expression / command list 

This command is the same as the global command £ except 
that the command list is executed with ' . ' initially 
set to every line that does not match the regular 
expression. 

(1,$)V/ regular expression / 

This command is the same as the interactive global com- 
mand G except that the lines that are marked during the 
first step are those that do not match the regular 
expression. 

(l,$)w filename 

The write command writes the addressed lines into the 
named file. If the file does not exist, it is created 
with mode 666 (readable and writable by everyone), 
unless your umask setting (see sh(l)) dictates other- 
wise. The currently remembered 'filename' is not 
changed unless filename is the very first file name 
mentioned since ed was invoked. If no 'filename' is 
given, the currently remembered 'filename', if any, is 
used (see e and f commands); '.' is unchanged. If the 
command is successful, the number of characters written 
is typed. If filename is replaced by !, the rest of 
the line is taken to be a shell (sh(l)) command whose 
standard input is the addressed lines. Such a shell 
command is not remembered as the current file name. 

(1,$)W filename 

This command is the same as w, except that the 
addressed lines are appended to the file. 

($)= The line number of the addressed line is typed. '.' is 
unchanged by this command. 

I shell command 

The remainder of the line after the ! is sent to the 
UNIX System shell (sh(l)) to be interpreted as a com- 
mand. Within the text of that command, the unescaped 
character % is replaced with the remembered file name; 
if a ! appears as the first character of the shell com- 
mand, it is replaced with the text of the previous 
shell command. Thus, ! ! will repeat the last shell 
command. If any expansion is performed, the expanded 
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line is echoed; ' . ' is unchanged. 

( .+l)<newline> 

An address alone on a line causes the addressed line to 
be printed. A blank line alone is equivalent to 
•.+lp'; it is useful for stepping through text. 

If an interrupt signal (ASCII DEL) is sent, ed prints a '?' 
and returns to its command level. 

Some size limitations: 512 characters per line, 256 charac- 
ters per global command list, 64 characters per file name, 
and 128K characters in the temporary file. The limit on the 
number of lines depends on the amount of core: each line 
takes 1 word. 

When reading a file, ed discards ASCII NUL characters and 
all characters after the last new-line. Files (e.g., a. out) 
that contain characters not in the ASCII set (bit 8 on) can- 
not be edited by ed. 

If the closing delimiter of a regular expression or of a 
replacement string (e.g., /) would be the last character 
before a new-line, that delimiter may be omitted, in which 
case the addressed line is printed. The following pairs of 
commands are equivalent: 

s/sl/s2 s/sl/s2/p 

g/sl g/sl/p 

?sl ?sl? 

FILES 

/tmp/e* 

ed.hup work is saved here if terminal hangs up 

SEE ALSO 

grep(l), sed(l), sh(l), stty(l) 

B. W. Kernighan, A Tutorial Introduction to the ED Text Edi- 
tor 
B. W. Kernighan, Advanced editing on UNIX 

DIAGNOSTICS 

'?name' for inaccessible file; '?' for errors in commands; 
'?TMP' for temporary file overflow. 

(use the help and Help commands for detailed explanations). 
To protect against throwing away valuable work, a g or e 
command is considered to be in error, unless a w has 
occurred since the last buffer change. A second g or e~will 
be obeyed regardless. 

RESTRICTIONS 

The 1. command mishandles DEL. 

A ! command cannot be subject to a 3 or a v command. 
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The ! command and the ! escape from the e, r, and w commands 
cannot be used if the the editor is invoked from a res- 
tricted shell (see sh(l) ) . 

Because is an illegal address for a w command, it is not 
possible to create an empty file with ed . 
Characters are masked to 7 bits on input. 
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NAME 

ed - text editor 

SYNOPSIS 

ed [ - ] [ name ] 

DESCRIPTION 

Ed is the standard text editor. 

If a name argument is given, ed simulates an e command (see 
belowl on the named file; that is to say, the file is read 
into ed's buffer so that it can be edited. The optional 
suppresses the printing of character counts by e, r, and w 
commands. 

Ed operates on a copy of any file it is editing; changes 
made in the copy have no effect on the file until a w 
(write) command is given. The copy of the text being edited 
resides in a temporary file called the buffer . 

Commands to ed have a simple and regular structure: zero or 
more addresses followed by a single character command , pos- 
sibly followed by parameters to the command. These 
addresses specify one or more lines in the buffer. Missing 
addresses are supplied by default. 

In general, only one command may appear on a line. Certain 
commands allow the addition of text to the buffer. While ed 
is accepting text, it is said to be in input mode . In this 
mode, no commands are recognized; all input is merely col- 
lected. Input mode is left by typing a period '.' alone at 
the beginning of a line. 

Ed supports a limited form of regular expression notation. 
A regular expression specifies a set of strings of charac- 
ters. A member of this set of strings is said to be matched 
by the regular expression. In the following specification 
for regular expressions the word 'character' means any char- 
acter but newline. 

1. Any character except a special character matches 
itself. Special characters are the regular expression 
delimiter plus \[. and sometimes '^*$. 

2. A . matches any character. 

3. A \ followed by any character except a digit or () 
matches that character. 

4. A nonempty string s bracketed [s] (or ['^s]) matches any 
character in (or not in) s. In s, \ has no special 
meaning, and ] may only appear as the first letter. A 
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substring a-b, with a and b in ascending ASCII order, 
stands for the inclusive range of ASCII characters. 

5. A regular expression of form 1-4 followed by * matches 
a sequence of or more matches of the regular expres- 
sion. 

6. A regular expression, x, of form 1-8, bracketed \(x\) 
matches what x matches. 

7. A \ followed by a digit n matches a copy of the string 
that the bracketed regular expression beginning with 
the nth \( matched. 

8. A regular expression of form 1-8, x, followed by a reg- 
ular expression of form 1-7, ^ matches a match for x 
followed by a match for y, with the x match being as 
long as possible while still permitting a ^ match. 

9. A regular expression of form 1-8 preceded by -^ (or fol- 
lowed by $), is constrained to matches that begin at 
the left (or end at the right) end of a line. 

10. A regular expression of form 1-9 picks out the longest 
among the leftmost matches in a line. 

11. An empty regular expression stands for a copy of the 
last regular expression encountered. 

Regular expressions are used in addresses to specify lines 
and in one command (see s below) to specify a portion of a 
line which is to be replaced. If it is desired to use one 
of the regular expression metacharacters as an ordinary 
character, that character may be preceded by '\'. This also 
applies to the character bounding the regular expression 
(often '/') and to 'X' itself. 

To understand addressing in ed it is necessary to know that 
at any time there is a current line . Generally speaking, the 
current line is the last line affected by a command; how- 
ever, the exact effect on the current line is discussed 
under the description of the command. Addresses are con- 
structed as follows. 

1. The character '.' addresses the current line. 

2. The character '$' addresses the last line of the 
buffer. 

3. A decimal number n addresses the n-th line of the 
buffer. 
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4. ' 'x' addresses the line marked with the name x, which 
must be a lower-case letter. Lines are marked~with the 
k command described below. 

5. A regular expression enclosed in slashes '/' addresses 
the line found by searching forward from the current 
line and stopping at the first line containing a string 
that matches the regular expression. If necessary the 
search wraps around to the beginning of the buffer. 

6. A regular expression enclosed in queries '?' addresses 
the line found by searching backward from the current 
line and stopping at the first line containing a string 
that matches the regular expression. If necessary the 
search wraps around to the end of the buffer. 

7. An address followed by a plus sign '+' or a minus sign 
'-' followed by a decimal number specifies that address 
plus (resp. minus) the indicated number of lines. The 
plus sign may be omitted. 

8. If an address begins with '+' or '-' the addition or 
subtraction is taken with respect to the current line; 
e.g. '-5' is understood to mean '.-5'. 

9. If an address ends with '+' or '-', then 1 is added 
(resp. subtracted). As a consequence of this rule and 
rule 8, the address '-' refers to the line before the 
current line. Moreover, trailing '+' and '-' charac- 
ters have cumulative effect, so ' — ' refers to the 
current line less 2. 

10. To maintain compatibility with earlier versions of the 
editor, the character ''^' in addresses is equivalent to 

• 

Commands may require zero, one, or two addresses. Commands 
which require no addresses regard the presence of an address 
as an error. Commands which accept one or two addresses 
assume default addresses when insufficient are given. If 
more addresses are given than such a command requires, the 
last one or two (depending on what is accepted) are used. 

Addresses are separated from each other typically by a comma 
','. They may also be separated by a semicolon ' ; ' . In 
this case the current line '.' is set to the previous 
address before the next address is interpreted. This 
feature can be used to determine the starting line for for- 
ward and backward searches ('/', '?'). The second address 
of any two-address sequence must correspond to a line fol- 
lowing the line corresponding to the first address. 
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In the following list of ed commands, the default addresses 
are shown in parentheses. The parentheses are not part of 
the address, but are used to show that the given addresses 
are the default. 

As mentioned, it is generally illegal for more than one com- 
mand to appear on a line. However, most commands may be 
suffixed by 'p' or by '1', in which case the current line is 
either printed or tisted respectively in the way discussed 
below. 

(.)a 
<text> 

• 

The append command reads the given text and appends it 
after the addressed line. '.' is left on the last line 
input, if there were any, otherwise at the addressed 
line. Address '0' is legal for this command; text is 
placed at the beginning of the buffer. 

( . , . )c 
<text> 

• 

The change command deletes the addressed lines, then 
accepts input text which replaces these lines. ' . ' is 
left at the last line input; if there were none, it is 
left at the line preceding the deleted lines. 

(., .)d 

The delete command deletes the addressed lines from the 
buffer. The line originally after the last line 
deleted becomes the current line; if the lines deleted 
were originally at the end, the new last line becomes 
the current line. 

e filename 

The edit command causes the entire contents of the 
buffer to be deleted, and then the named file to be 
read in. '.' is set to the last line of the buffer. 
The number of characters read is typed. 'filename' is 
remembered for possible use as a default file name in a 
subsequent £ or w command. If 'filename' is missing, 
the remembered name is used. 

E filename 

This command is the same as e, except that no diagnos- 
tic results when no w has been given since the last 
buffer alteration. 

f filename 

The filename command prints the currently remembered 
file name. If 'filename' is given, the currently 
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remembered file name is changed to 'filename'. 

(l,$)g/regular expression/command list 

In the global command, the first step is to mark every 
line which matches the given regular expression. Then 
for every such line, the given command list is executed 
with '.' initially set to that line. A single command 
or the first of multiple commands appears on the same 
line with the global command. All lines of a multi- 
line list except the last line must be ended with '\'. 
A, J^, and c commands and associated input are permit- 
ted; the '.' terminating input mode may be omitted if 
it would be on the last line of the command list. The 
commands 3 and v are not permitted in the command list. 



(.)i 

<text> 

• 

This command inserts the given text before the 
addressed line. '.' is left at the last line input, 
or, if there were none, at the line before the 
addressed line. This command differs from the a com- 
mand only in the placement of the text. 

(., .+l)j 

This command joins the addressed lines into a single 
line; intermediate newlines simply disappear. '.' is 
left at the resulting line. 

( . )kx 

The mark command marks the addressed line with name x, 
which must be a lower-case letter. The address form 
' 'x' then addresses this line. 

(., .)1 

The list command prints the addressed lines in an unam- 
biguous way: non-graphic characters are printed in 
two-digit octal, and long lines are folded. The 1 com- 
mand may be placed on the same line after any non-i/o 
command . 

( . , . )ma 

The move command repositions the addressed lines after 
the line addressed by a. The last of the moved lines 
becomes the current line. 

(. , .)p 

The print command prints the addressed lines. '.' is 

left at the last line printed. The g command may be 

placed on the same line after any non-i/o command. 
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(., .)P 

This command is a synonym for p. 

q The quit command causes ed to exit. No automatic write 
of a file is done. 

Q This command is the same as g, except that no diagnos- 
tic results when no w has been given since the last 
buffer alteration. 

($)r filename 

The read command reads in the given file after the 
addressed line. If no file name is given, the remem- 
bered file name, if any, is used (see e and f com- 
mands). The file name is remembered If there was no 
remembered file name already. Address '0' is legal for 
r and causes the file to be read at the beginning of 
the buffer. If the read is successful, the number of 
characters read is typed. '.' is left at the last line 
read in from the file. 

( ., .)s/regular expression/replacement/ or, 

( ., .)s/regular expression/replacement/g 

The substitute command searches each addressed line for 
an occurrence of the specified regular expression. On 
each line in which a match is found, all matched 
strings are replaced by the replacement specified, if 
the global replacement indicator 'g' appears after the 
command. If the global indicator does not appear, only 
the first occurrence of the matched string is replaced. 
It is an error for the substitution to fail on all 
addressed lines. Any character other than space or 
new-line may be used instead of '/' to delimit the reg- 
ular expression and the replacement. '.' is left at 
the last line substituted. 

An ampersand '&' appearing in the replacement is 
replaced by the string matching the regular expression. 
The special meaning of '&' in this context may be 
suppressed by preceding it by '\'. The characters '\n' 
where n is a digit, are replaced by the text matched by 
the n-th regular subexpression enclosed between '\(' 
and 'X)'. When nested, parenthesized subexpressions 
are present, n is determined by counting occurrences of 
'\(' starting from the left. 

Lines may be split by substituting new-line characters 
into them. The new-line in the replacement string must 
be escaped by preceding it by '\'. 
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( . , . )ta 

This command acts just like the m conunand, except that 
a copy of the addressed lines is placed after address a 
(which may be 0). '.'is left on the last line of thi 
copy. 

( . , . )u 

The undo command restores the preceding contents of the 
current line, which must be the last line in which a 
substitution was made. 

(1, $)v/regular expression/command list 

This command is the same as the global command g except 
that the command list is executed 3 with '.' initially 
set to every line except those matching the regular 
expression. 

(1, $)w filename 

The write command writes the addressed lines onto the 
given file. If the file does not exist, it is created 
mode 666 (readable and writable by everyone). The file 
name is remembered if there was no remembered file name 
already. If no file name is given, the remembered file 
name, if any, is used (see e and f commands). '.' is 
unchanged. If the command is successful, the number of 
characters written is printed. 

(1,$)W filename 

This command is the same as w, except that the 
addressed lines are appended to the file. 

($)= The line number of the addressed line is typed. '. 
unchanged by this command. 

!<shell command> 

The remainder of the line after the '!' is sent 
sh(l) to be interpreted as a command. '.' 
unchanged. 



is 



to 

is 



( .+l)<newline> 

An address alone on a line causes the addressed line to 
be printed. A blank line alone is equivalent to 
'.+lp'; it is useful for stepping through text. 

If an interrupt signal (ASCII DEL) is sent, ed prints a '?' 
and returns to its command level. — 

Some size limitations: 512 characters per line, 256 charac- 
ters per global command list, 64 characters per file name, 
and 128K characters in the temporary file. The limit on the 
number of lines depends on the amount of core: each line 
takes 1 word. 
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When reading a file, ed discards ASCII NUL characters and 
all characters after the last newline. It refuses to read 
files containing non-ASCII characters. 

FILES 

/tmp/e* 

ed.hup: work is saved here if terminal hangs up 

SEE ALSO 

B. W. Kernighan, A Tutorial Introduction to the ED Text Edi- 
tor 

B. W. Kernighan, Advanced editing on UNIX 
sed(l) 

DIAGNOSTICS 

'?name' for inaccessible file; '?' for errors in commands; 
'?TMP' for temporary file overflow. 

To protect against throwing away valuable work, a g or e 
command is considered to be in error, unless a w has 
occurred since the last buffer change. A second q or e will 
be obeyed regardless. 

RESTRICTIONS 

The 1 command mishandles DEL. 

A ! command cannot be subject to a 3 command. 

Because is an illegal address for a w command, it is not 

possible to create an empty file with ed. 
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NAME 

eqn, neqn, checkeq — typeset mathematics 

SYNOPSIS 

eqn ( -dxy 1 [ -pn 1 [ -sn ] ( -fn ] [ file ] ... 
checkeq [file ] ... 

DESCRIPTION 

Eqn is a troff(l) preprocessor for typesetting mathematics on a Graphic Systems photo- 
typesetter, neqn on terminals. Usage is almost always 

eqn file ... | troff 
neqn file ... | nroff 

If no files are specified, these programs reads from the standard input. A line beginning with 
'.EQ' marks the start of an equation; the end of an equation is marked by a line beginning with 
'.EN'. Neither of these lines is altered, so they may be defined in macro packages to get 
centering, numbering, etc. It is also possible to set two characters as 'delimiters'; subsequent 
text between delimiters is also treated as eqn input. Delimiters may be set to characters xand y 
with the command-line argument — d^ryor (more commonly) with 'delim xy" between .EQ and 
.EN. The left and right delimiters may be identical. Delimiters are turned off by 'delim off'. 
All text that is neither between delimiters nor between .EQ and .EN is passed through un- 
touched. 

The program checkeq reports missing or unbalanced delimiters and .EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, newlines, braces, double quotes, tildes or 
circumflexes. Braces {} are used for grouping; generally speaking, anywhere a single character 
like X could appear, a complicated construction enclosed in braces may be used instead. Tilde " 
represents a full space in the output, circumflex * half as much. 

Subscripts and superscripts are produced with the keywords sub and sup. Thus x sub i makes x,, 
a sub i sup 2 produces ai^, and e sup {x sup 2 + y sup 2] gives e'^■^>'^ 

Fractions are made with over: a over b yields — . 

b 

sqrt makes square roots: 1 over sqrt [ax sup 2 -^bx-^-c] results in . 

yJax^+bx+c 

The keywords from and to introduce lower and upper limits on arbitrary things: lim Tx, is 

""" 

made with lim from {n—> inf] sum from to n x sub i. 

Left and right brackets, braces, etc., of the right height are made with left and right: left fx sup 



2 •¥ y sup 2 over alpha right J'^'l produces 



x'+^ 
a 



1 . The right clause is optional. Legal 



characters after left and right are braces, brackets, bars, c and f for ceiling and floor, and "" for 
nothing at all (useful for a right-side-only bracket). 

Vertical piles of things are made with pile, Ipile, cplle, and rpile: pile {a above b above c] pro- 

a 
duces b. There can be an arbitrary number of elements in a pile. Ipile left-justifies, pile and 

cpile center, with different vertical spacing, and rpile right justifies. 

Matrices are made with matrix: matrix [ Icol [ x sub i above y sub 2] ccol { 1 above 2 } ) pro- 

X, 1 

duces y^ 2- '" addition, there is rcol for a right-justified column. 



EQN (1 ) EQN (1 ) 

Diacritical marks are made with dot, dotdot. hat, tilde, bar, vec, dyad, and under: x dot -■ JtO 

bar is x^fit) , y dotdot bar'"' n under is J? -■ n, and x vec ' "' y dyad is x — J. 

Sizes and font can be changed with size n or size ± n, roman, Italic, bold, and font n. Size and 
fonts can be changed globally in a document by gsize n and gfont n, or by the command-line 
arguments — s/iand —in. 

Normally subscripts and superscripts are reduced by 3 point sizes from the previous size; this 
may be changed by the command-line argument — pn. 

Successive dtsplay arguments can be lined up. Place mark before the desired lineup point in 
the first equation; place lineup at the place that is to line up vertically in subsequent equations. 

Shorthands may be defined or existing keywords redefined with define; define thing % replace- 
ment % defines a new token called thing which will be replaced by replacement whenever it ap- 
pears thereafter. The % may be any character that does not occur in replacement. 

Keywords like sum (J^) "" (J ) inf(.°°) and shorthands like >- (» -> (-»), and !— {t^) 
are recognized. Greek letters are spelled out in the desired case, as in alpha or GAMMA. 
Mathematical words like sin, cos, log are made Roman automatically. Troff(.\) four-character 
escapes like \(bs (@) can be used anywhere. Strings enclosed in double quotes "..." are passed 
through untouched; this permits keywords to be entered as text, and can be used to communi- 
cate with fro#when ail else fails. 

SEE ALSO 

troff(l), tbl(l), ms(7). eqnchar(7) 

B. W. Kernighan and L. L. Cherry, Typesetting Mathematics— User's Guide 

J. F. Ossanna, NROFFITROFF User's Manual 

BUGS 

To embolden digits, parens, etc., it is necessary to quote them, as in 'bold "12.3"'. 
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NAME 

ex, edit - text editor 

SYNOPSIS 

ex [ - ] [ -V ] [ -r ] [ + command ] [ -1 ] name ... 
edit [ ex options ] 

DESCRIPTION 

Ex is the root of a famii;y of editors: edit: , ex and vi. Ex 
IS a superset of ed, with the most notable extension being a 
display editing facility. Display based editing is the 
focus of vi. 

If you have not used ed, or are a casual user, you will find 
that the editor edit is convenient for you. It avoids some 
of the complexities of ex used mostly by systems programmers 
and persons very familiar with ed. 

If you have a CRT terminal, you may wish to use a display 
based editor; in this case see W(l), which is a command 
which focuses on the display editing portion of ex. 

DOCUMENTATION 

The document Edit: A tutorial provides a comprehensive 
introduction to edit assuming no previous knowledge of com- 
puters or the UNIX system. 

The Ex Reference Manual - Version 3.5 is a comprehensive and 
complete manual for the command mode features of ex, but you 
cannot learn to use the editor by reading it. FoF~an intro- 
duction to more advanced forms of editing using the command 
mode of ex see the editing documents written by Brian Ker- 
nighan for the editor ed; the material in the introductory 
and advanced documents works also with ex. 

An Introduction to Display Editing with Vi introduces the 
display editor vi^ and provides reference material on vi. All 
of these documents can be found in volume 2c of the 
Programmer's Manual. In addition, the Vj^ Quick Reference 
card summarizes the commands of vi in a useful, functional 
way, and is useful with the Introduction . 

FILES 

/usr/lib/ex?.?strings error messages 
/usr/lib/ex?.?recover recover command 
/usr/lib/ex?.?preserve preserve command 

/etc/termcap describes capabilities of terminals 

~/.exrc editor startup file 

/tmp/Exnnnnn editor temporary 

/tmp/Rxnnnnn named buffer temporary 

/usr/preserve preservation directory 
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SEE ALSO 

awk(l), ed(l), grep(l), sed(l), grep(l), vi(l), ternicap(5), 
environ(5) 

AUTHOR 

Originally written by William Joy 

Mark Horton has maintained the editor since version 2.7, 
adding macros, support for many unusual terminals, and other 
features such as word abbreviation mode. 

RESTRICTIONS 

The undo command causes all marks to be lost on lines 
changed and then restored if the marked lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physi- 
cal lines. More than a screen full of output may result if 
long lines are present. 

File input/output errors don't print a name if the command 
line '-' option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers 
and not used before exiting the editor. 

Null characters are discarded in input files, and cannot 
appear in resultant files. 
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NAME 



expr - evaluate arguments as an expression 



SYNOPSIS 

expr arg . , , 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, 
the result is written on the standard output. Each token of 
the expression is a separate argument. 

The operators and keywords are listed below. The list is in 
order of increasing precedence, with equal precedence opera- 
tors grouped. 

expr I expr 

yields the first expr if it is neither null nor '0', 
otherwise yields the second expr . 

expr & expr 

yields the first expr if neither expr is null or '0*, 
otherwise yields '0'. 

expr relop expr 

where relop is one of < <= = != >= >, yields '1' if the 
indicated comparison is true, '0' if false. The com- 
parison is numeric if both expr are integers, otherwise 
lexicographic. 

expr + expr 

expr - expr 

addition or subtraction of the arguments. 

expr * expr 

expr / expr 
expr % expr 

multiplication, division, or remainder of the argu- 
ments. 



expr : expr 

The matching operator compares the string first argu- 
ment with the regular expression second argument; regu- 
lar expression syntax is the same as that of ed ( 1 ) . 
The \(...\) pattern symbols can be used to select a 
portion of the first argument. Otherwise, the matching 
operator yields the number of characters matched ('0' 
on failure) . 

( expr ) 

parentheses for grouping. 
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Examples: 

To add 1 to the Shell variable a: 

a="expr $a + 1^ 

To find the filename part (least significant part) of the 
pathname stored in variable a, which may or may not contain 

expr $a : ' .*/\(.*\)' ' I ' $a 

Note the quoted Shell metacharacters. 

SEE ALSO 

ed(l), sh(l), test(l) 

DIAGNOSTICS 

Expr returns the following exit codes: 

if the expression is neither null nor '0', 

1 if the expression is null or '0', 

2 for invalid expressions. 
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NAME 

f77 - Fortran 77 compiler 

SYNOPSIS 

f77 [ option ] ... file ... 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler. It accepts several 
types of arguments: 

Argxjments whose names end with '.f are taken to be Fortran 
77 source programs; they are compiled, and each object pro- 
gram is left on the file in the current directory whose name 
is that of the source with ' .o' substituted for '.f. 

Arguments whose names end with '.r' or '.e' are taken to be 
Ratfor or EFL source programs, respectively; these are first 
transformed by the appropriate preprocessor, then compiled 
by f77. 

In the same way, arguments whose names end with '.c' or '.s' 
are taken to be C or assembly source programs and are com- 
piled or assembled, producing a ' .o' file. 

The following options have the same meaning as in cc(l). 
See ld(l) for load-time options. 

-c Suppress loading and produce ' .o' files for each source 
file. 

-p Prepare object files for profiling, see prof (1) . 

-0 Invoke an object-code optimizer. 

-S Compile the named programs, and leave the assembler- 
language output on corresponding files suffixed '.s'. 
(No ' .o' is created.). 

-f Use a floating point interpreter (for PDPll's that lack 
11/70-style floating point). 

-o output 

Name the final output file output instead of 'a. out'. 

-V Produce code suitable for using in overlaid programs. 
This is a default flag. 

-V7 Turn off the -V flag. This is provided for backwards 
compatibility with older versions of f77 , but in gen- 
eral should not be used. 
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The following options are peculiar to f77 . 

-onetrip 

Compile DO loops that are performed at least once if 

reached. (Fortran 77 DO loops are not performed at all 

if the upper limit is smaller than the lower limit.) 

-u Make the default type of a variable 'undefined' rather 
than using the default Fortran rules. 

-C Compile code to check that subscripts are within 
declared array bounds. 

-w Suppress all warning messages. If the option is 
'-w66', only Fortran 66 compatibility warnings are 
suppressed. 

-F Apply EFL and Ratfor preprocessor to relevant files, 
put the result in the file with the suffix changed to 
'.f, but do not compile. 

-m Apply the M4 preprocessor to each '.r' or '.e' file 
before transforming it with the Ratfor or EFL prepro- 
cessor. 

-Ex Use the string x as an EFL option in processing '.e' 
files. 

-Rx Use the string x as a Ratfor option in processing '.r' 
files. 

-N[qxscn] nnn 

Make static tables in the compiler bigger. The compiler 
will complain if it overflows its tables and suggest 
you apply one or more of these flags. These flags have 
the following meanings: 

q Maximum number of equivalenced variables. Default 
is 150. 

X Maximum number of external names (common block 
names, subroutine and function names). Default is 
200. 

s Maximum number of statement numbers. Default is 
201. 

c Maximum depth of nesting for control statements 
(e.g. DO loops). Default is 20. 

n Maximum number of identifiers. Default is 401. 
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Programs do not always require the full default space 
assigned to them. Accordingly, one of these default values 
may be reduced in order to accommodate an increased value 
for some other flag (see table below). In the case of much 
larger programs, static table space is at a premium. There- 
fore, experimentation with different values for these flags 
is sometimes required so that the compiler will not com- 
plain. 

Storage costs associated with these optional flags are: 

flag default value cost ea. default cost 



s 201 8 bytes 1608 bytes 

q 150 12 bytes 1800 bytes 

X 200 20 bytes 4000 bytes 

c 20 18 bytes 360 bytes 

n 401 4 bytes 1604 bytes 

-T[12alFM] file 

Use alternate programs for various passes of compila- 
tion. 

Ifile 

Use file for the back end of the compiler, instead 
of /TIbZcl. 

2file 

Use file as the optimizer, instead of / lib /c2. 

afile 

Use file as the assembler, instead of /bin/as. 

I file 

Use file as the loader, instead of /bin/Id. 

F f ile 

Use file as the footname (startup code), instead 
of /TWcrtO. 

M f ile 

Use file as the macro processor with the -m flag, 
instead of / usr / bin /m4. 

Other arguments are taken to be either loader option argu- 
ments, or F77-compatible object programs, typically produced 
by an earlier run, or perhaps libraries of F77-compatible 
routines. These programs, together with the results of any 
compilations specified, are loaded (in the order given) to 
produce an executable program with name 'a. out'. 
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FILES 



file.Cfresc] input file 
file.o object file 

a. out loaded output 

/usr/lib/f 77passl compiler 



/lib/cl 

/lib/c2 

/usr/lib/libF77.a 

/usr/lib/libI77.a 

/lib/libc.a 



pass 2 

optional optimizer 

intrinsic function library 

Fortran I/O library 

C library, see section 3 



SEE ALSO 

S. I. Feldman, : 

piler 

prof(l), cc(l), 



•, J. Weinberger, A Portable Fortran 77 Com- 
Idd) 



DIAGNOSTICS 

The diagnostics produced by f77 
self-explanatory. Occasional 
the loader. 



itself are intended to be 
messages may be produced by 



RESTRICTIONS 

The Fortran 66 subset of the language has 
extensively; the newer features have not. 



been exercised 
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NAME 

factor, primes - factor a number, generate large primes 

SYNOPSIS 

factor [ number ] 

primes 

DESCRIPTION 

When factor is invoked without an argument, it waits for a 
number to be typed in. If you type in a positive number 
less than 256 (about 7.2el6) it will factor the number and 
print its prime factors; each one is printed the proper 
number of times. Then it waits for another number. It 
exits if it encounters a zero or any non-numeric character. 

If factor is invoked with an argument, it factors the n\amber 
as above and then exits. 

Maximum time to factor is proportional to sqrt(n) and occurs 
when n is prime or the square of a prime. It takes 1 minute 
to factor a prime near 1014 on a PDPll. 

When primes is invoked, it waits for a number to be typed 
in. If you type in a positive number less than 256 it will 
print all primes greater than or equal to this number. 

DIAGNOSTICS 

'Ouch.' for input out of range or for garbage input. 
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NAME 

file - determine file type 

SYNOPSIS 

file file ... 

DESCRIPTION 

File performs a series of tests on each argument in an 
attempt to classify it. If an argument appears to be ascii, 
file examines the first 512 bytes and tries to guess its 
language. 

RESTRICTIONS 

It often makes mistakes. In particular it often suggests 
that command files are C programs. 
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NAME 

find - find files 

SYNOPSIS 

find pathname-list expression 

DESCRIPTION 

Find recursively descends the directory hierarchy for each 
pathname in the pathname - list (i.e., one or more pathnames) 
seeking files that match a boolean expression written in the 
primaries given below. In the descriptions, the argument n 
is used as a decimal integer where +n means more than n, -n 
means less than n and n means exactly n. 

-name filename 

True if the filename argument matches the current 
file name. Normal Shell argument syntax may be 
used if escaped (watch out for '[', '?' and '*'). 

-perm onum 

True if the file permission flags exactly match 
the octal number onum (see chmod (l) ) . If onum is 
prefixed by a minus sign, more flag bits (017777, 
see Stat (2) ) become significant and the flags are 
compared: ( f lags & onum ) == onum . 

-type c True if the type of the file is c, where c is b, 
c, d or f for block special file, character spe- 
cial file, directory or plain file. 

-links n True if the file has n links. 

-user uname 

True if the file belongs to the user uname (login 
name or numeric user ID) . 

-group gname 

True if the file belongs to group gname (group 
name or numeric group ID). 

-size n True if the file is n blocks long (512 bytes per 
block). 

-inum n True if the file has inode number n. 

-atime n True if the file has been accessed in n days. 

-mtime n True if the file has been modified in n days. 

-exec command 

True if the executed command returns a zero value 
as exit status. The end of the command must be 
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punctuated by an escaped semicolon. A command 
arg\ament '{}' is replaced by the current pathname. 

-ok command 

Like -exec except that the generated command is 
written on the standard output, then the standard 
input is read and the command executed only upon 
response y. 

-print Always true; causes the current pathname to be 
printed. 

-newer file 

True if the current file has been modified more 
recently than the argument file . 

The primaries may be combined using the following operators 
(in order of decreasing precedence): 

1) A parenthesized group of primaries and operators 
(parentheses are special to the Shell and must be 
escaped) . 

2) The negation of a primary ('!' is the unary not opera- 
tor) . 

3) Concatenation of primaries (the and operation is implied 
by the juxtaposition of two primaries). 

4) Alternation of primaries ('-o' is the or operator). 

EXAMPLE 

To remove all files named 'a.out' or '*.o' that have not 
been accessed for a week: 

find / \( -name a.out -o -name '*.o' \) -atime +7 -exec rm {} \; 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

sh(l), test(l), filsys(5) 

RESTRICTIONS 

The syntax is painful. 
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NAME 

finger - user information lookup program 

SYNOPSIS 

finger [ options ] name ... 

DESCRIPTION 

By default finger lists the login name, full name, terminal 
name and write status (as a '*' before the terminal name if 
write permission is denied), idle time, login time, and 
office location and phone number (if they are known) for 
each current UNIX user. (idle time is minutes if it is a 
single integer, hours and minutes if a ':' is present, or 
days and hours if a 'd' is present.) 

A longer format also exists and is used by finger whenever a 
list of peoples names is given. (Account names as well as 
first and last names of users are accepted.) This format is 
multi-line, and includes all the information described above 
as well as the user's home directory and login shell, any 
plan which the person has placed in the file . plan in their 
home directory, and the project on which they are working 
from the file . project also in the home directory. 

Finger options include: 

-b Slightly briefer version (long format). 

-f Suppress the printing of the header line (short for- 
mat) . 

-h Suppress printing of the . project files. 

-i Quick list (-q) with idle times. 

-1 Force long output format. 

-p Suppress printing of the . plan files. 

-q Quick list (similar to who ( 1 ) ) . 

-s Force short output format. 

-w Narrow format output (short format). 

FILES 

/etc/utmp who file 

/etc/passwd for users names, offices, phones, 

directories, and shells 
~/.plan plans 

~/. project projects 
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SEE ALSO 

who ( 1 ) 

AUTHOR 

Earl T. Cohen 

RESTRICTIONS 

Only the first line of the . project file is printed. 
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NAME 

fpsim - report or change the status of floating point simu- 
lation 

SYNOPSIS 

/etc/fpsim [ mode ] 

DESCRIPTION 

Fpsim without any arguments will report the current status 
of the kernel floating point simulator, it i_s either 
enabled, disabled, or not configured in. If mode is speci- 
fied it must be either onoroff, which will respectively 
enable or disable the simulator, provided that the simulator 
was configured into the current system. The new state is 
then reported. Only the super user is allowed to change the 
status of the simulator. 

SEE ALSO 

fpsim(2) 

RESTRICTIONS 

This command is only temporary, It is intended only for use 
if the kernel floating point simulator should blow up. Once 
it has been more thoroughly tested and verified there will 
no longer be a need to be able to turn it off on a running 
system. 
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NAME 



from - who is my mail from? 



SYNTAX 

from [ -f [ mailbox ] ] [ -s sender ] 

DESCRIPTION 

From prints out the mail header lines in a mailbox file to 
show you who your mail is from. The -f_ option causes from 
to examine the mail header lines in your mbox (or the speci- 
fied file). If the -s option is given, then only headers 
for mail sent by sender are printed. 



FILES 



/usr/spool/mail/* 



SEE ALSO 

mail(l) 
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NAME 

fsck - file system consistency check and interactive repair 

SYNOPSIS 

fsck [ option ] ... [ filesystem ] ... 

DESCRIPTION 

^sck audits and interactively repairs inconsistent condi- 
tions for the named filesystems . If a file system is con- 
sistent then the niunber of files, number of blocks used, and 
number of blocks free are reported. If the file system is 
inconsistent the operator is prompted for concurrence before 
each correction is attempted. Most corrections lose data; 
all losses are reported. The default action for each 
correction is to wait for the operator to respond 'yes' or 
'no'. Without write permission fsck defaults to -n action. 

These options are recognized: 

-y Assume a yes response to all questions. 

-n Assume a no response to all questions. 

-sX Ignore the actual free list and (unconditionally) con- 
struct a new one by rewriting the super-block of the 
file system. The file system should be unmounted while 
this is done, or extreme care should be taken that the 
system is quiescent and that it is rebooted immediately 
afterwards. This precaution is necessary so that the 
old, bad, in-core copy of the superblock will not con- 
tinue to be used, or written on the file system. 

The free list is created with optimal interleaving 
according to the specification X: 

-s3 optimal for RP03 on PDPll/45 CPU 
-s4 optimal for RP04, RP05, RP06 on PDPll/70 CPU 
-sc:s space free blocks s blocks apart in 
cylinders of c blocks each. 

If X is not given, the values used when the filesystem 
was created are used. If these values were not speci- 
fied, then c=400, s=9 is assumed. The '-s' without X 
is recommended when rebuilding free lists on ULTRIX-11 
file systems, because mkfs (1) saves the optimum inter- 
leave factors in the super-block when the file system 
is created. 

-SX Conditionally reconstruct the free list. This option 
is like -sX except that the free list is rebuilt only 
if there were no discrepancies discovered in the file 
system. It is useful for forcing free list 
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reorganization on uncontaminated file systems. -S 
forces -n. 

-t If fsck cannot obtain enough memory to keep its tables, 
it uses a scratch files. If the -t option is speci- 
fied, the file named in the next argument is used as 
the scratch file. Without the -t option, fsck prompts 
if it needs a scratch file. The file should not be on 
the file system being checked, and if it is not a spe- 
cial file or did not already exist, it is removed when 
fsck completes. 

If no filesystems are given to fsck then a default list of 
file systems is read from the file /etc/fstab. 

Inconsistencies checked are as follows: 

1. Blocks claimed by more than one inode or the free list. 

2. Blocks claimed by an inode or the free list outside the 
range of the file system. 

3. Incorrect link counts. 

4. Size checks: 

Incorrect number of blocks in file. 
Directory size not a multiple of 16 bytes. 

5. Bad inode format. 

6. Blocks not accounted for anywhere. 

7. Directory checks: 

File pointing to unallocated inode. 
Inode number out of range. 

8. Super Block checks: 
More than 65536 inodes. 

More blocks for inodes than there are in the file sys- 
tem. 

9. Bad free block list format. 

10. Total free block and/or free inode count incorrect. 

Orphaned files and directories (allocated but unreferenced) 
are, with the operator's concurrence, reconnected by placing 
them in the "lost+found" directory. The name assigned is 
the inode number. The only restriction is that the directory 
"lost+found" must preexist in the root of the filesystem 
being checked and must have empty slots in which entries can 
be made. This is accomplished by making "lost+found". 
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copying a niimber of files to the directory, and then remov- 
ing them (before fsck is executed). 

Checking the raw device is almost always faster. 

When checking the root file system the block device should 
be used. Fsck will force a reboot if any repairs were done 
on the root file system. 

FILES 

/etc/fstab - default file system check list 

SEE ALSO 

dcheck(l), icheck(l), filsys(5), fstab(5) 

ULTRIX-11 System Management Guide, Sections 4.1, 4.6, and 

5.1.3 

RESTRICTIONS 

Inode n\ambers for . and .. in each directory should be 

checked for validity. 

The -b option of icheck(l) should be available. 
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NAME 

fsdb - file system debugger 

SYNOPSIS 

/etc/fsdb special [ - ] 

DESCRIPTION 

Fsdb can be used to patch up a damaged file system after a 
crash. It has conversions to translate block and i-numbers 
into their corresponding disk addresses. Also included are 
mnemonic offsets to access different parts of an i-node. 
These greatly simplify the process of correcting control 
block entries or descending the file system tree. 

Fsdb contains several error checking routines to verify i- 
node and block addresses. These can be disabled if neces- 
sary by invoking fsdb with the optional - argument or by the 
use of the symbol. (Fsdb reads the i-size and f-size 
entries from the superblock of the file system as the basis 
for these checks.) 

Numbers are considered decimal by default. Octal numbers 
must be prefixed with a zero. During any assignment opera- 
tion, numbers are checked for a possible truncation error 
due to a size mismatch between source and destination. 

Fsdb reads a block at a time and will therefore work with 
raw as well as block I/O. A buffer management routine is 
used to retain commonly used blocks of data in order tr 
reduce the number of read system calls. All assignment 
operations result in an immediate write-through of the 
corresponding block. 

The symbols recognized by fsdb are: 

# absolute address 

i convert from i-number to i-node address 

b convert to block address 

d directory slot offset 

+,- address arithmetic 

q quit 

>,< save, restore an address 

numerical assignment 

=+ incremental assignment 

=- decremental assignment 

" =" character string assignment 

error checking flip flop 

p general print facilities 

f file print facility 

B byte mode 

W word mode 

D double word mode 

! escape to shell 
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The print facilities generate a formatted output in various 
styles. The current address is normalized to an appropriate 
boundary before printing begins. It advances with the 
printing and is left at the address of the last item 
printed. The output can be terminated at any time by typing 
the delete character. if a number follows the p symbol, 
that many entries are printed. A check is made to detect 
block boundary overflows since logically sequential blocks 
are generally not physically sequential. If a count of zero 
is used, all entries to the end of the current block are 
printed. The print options available are: 

i print as i-nodes 

d print as directories 

o print as octal words 

e print as decimal words 

c print as characters 

b print as octal bytes 

The f symbol is used to print data blocks associated with 
the current i-node. If followed by a number, that block of 
the file is printed. (Blocks are numbered from zero.) The 
desired print option letter follows the block number, if 
present, or the f symbol. This print facility works for 
small as well as large files. It checks for special devices 
and that the block pointers used to find the data are not 
zero. 

Dots, tabs and spaces may be used as function delimiters but 
are not necessary. A line with just a new-line character 
will increment the current address by the size of the data 
type last printed. That is, the address is set to the next 
byte, word, double word, directory entry or i-node, allowing 
the user to step through a region of a file system. Infor- 
mation is printed in a format appropriate to the data type. 
Bytes, words and double words are displayed with the octal 
address followed by the value in octal and decimal. A .B or 
.D is appended to the address for byte and double word 
values, respectively. Directories are printed as a direc- 
tory slot offset followed by the decimal i-number and the 
character representation of the entry name. Inodes are 
printed with labeled fields describing each element. 

The following mnemonics are used for i-node examination and 
refer to the current working i-node: 

md mode 

In link count 

uid user ID number 

gid group ID number 

sO high byte of file size 

si low word of file size 
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a# 

at 

mt 

maj 

min 



EXAMPLES 
386i 



ln=4 

ln=+l 
fc 

2i.fd 

d5i .fc 



Ib.pOo 
2i.a0b.d7=3 



d7.nm="name" 



data block numbers (0 - 12) 
access time 
modification time 
major device number 
minor device number 



prints i-number 386 in an i-node format. 
This now becomes the current working i-node. 

changes the link count for the working i- 
node to 4 . 

increments the link count by 1. 

prints, in ASCII, block zero of the file 
associated with the working i-node. 

prints the first 32 directory entries for 
the root i-node of this file system. 

changes the current i-node to that associ- 
ated with the 5th directory entry (numbered 
from zero) found from the above command. 
The first 512 bytes of the file are then 
printed in ASCII. 

prints the superblock of this file system in 
octal. 

changes the i-number for the seventh direc- 
tory slot in the root directory to 3. This 
example also shows how several operations 
can be combined on one command line. 

changes the name field in the directory slot 
to the given string. Quotes are optional 
when used with nm if the first character is 
alphabetic. 



SEE ALSO 

fsck(l), dir(5), filsys(5), ipatch(l) 
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NAME 

get - get a version of an SCCS file 

SYNOPSIS 

get [-rSID] [-ccutoff] [-ilist] [-xlist] C-aseq-no.] [-k] 
[-e] [-![£]] [-p] [-m] [-n] [-s] [-b] [-g] [-t] file ... 

DESCRIPTION 

Get generates an ASCII text file from each named SCCS file 
according to the specifications given by its keyletter argu- 
ments, which begin with -. The arguments may be specified 
in any order, but all keyletter arguments apply to all named 
SCCS files. If a directory is named, get behaves as though 
each file in the directory were specified as a named file, 
except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently 
ignored. If a name of - is given, the standard input is 
read; each line of the standard input is taken to be the 
name of an SCCS file to be processed. Again, non-SCCS files 
and unreadable files are silently ignored. 

The generated text is normally written into a file called 
the g- file whose name is derived from the SCCS file name by 
simply removing the leading s.; (see also FILES , below). 

Each of the keyletter arguments is explained below as though 
only one SCCS file is to be processed, but the effects of 
any keyletter argument applies independently to each named 
file . 

-'"SID The sees IDentification string (SID) of the ver- 

sion (delta) of an SCCS file to be retrieved. 
Table 1 below shows, for the most useful cases, 
what version of an SCCS file is retrieved (as 
well as the SID of the version to be eventually 
created by delta(l) if the -e keyletter is also 
used), as a function of the SID specified. 

-c cutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were 
created after the specified cutoff date-time are 
included in the generated ASCII text file. Units 
omitted from the date-time default to their max- 
imum possible values; that is, -c7502 is 
equivalent to -c750228235959. Any number of 
non-numeric characters may separate the various 2 
digit pieces of the cutoff date-time. This 
feature allows one to specify a cutoff date in 
the form: "-c77/2/2 9:22:25". Note that this 
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implies that one may use the %E% and %\]% identif- 
ication keywords (see below) for nested gets 
within, say the input to a send ( 1 C) command: 

~!get "-c%E% %U%» s.file 

-e Indicates that the get is for the purpose of 

editing or making a change (delta) to the SCCS 
file via a subsequent use of delta d ) . The -e 
keyletter used in a get for a particular version 
(SID) of the SCCS file prevents further get s for 
editing on the same SID until delta is executed 
or the j (joint edit) flag is set in the SCCS 
file (see admin(l)). Concurrent use of get -e 
for different SIDs is always allowed. 

If the g- file generated by get with an -e 
keyletter is accidentally ruined in the process 
of editing it, it may be regenerated by re- 
executing the get command with the -k keyletter 
in place of the -e keyletter. 

SCCS file protection specified via the ceiling, 
floor, and authorized user list stored in the 
SCCS file (see admin d )) are enforced when the -e 
keyletter is used . 

-b Used with the -e keyletter to indicate that the 

new delta should have an SID in a new branch as 
shown in Table 1. This keyletter is ignored if 
the b flag is not present in the file (see 
admin d )) or if the retrieved delta is not a leaf 
delta ♦ (A leaf delta is one that has no succes- 
sors on the SCCS file tree.) 

Note: A branch delta may always be created from a 
non-leaf delta . 

-i list A list of deltas to be included (forced to be 

applied) in the creation of the generated file. 
The list has the following syntax: 

<list> ::= <range> | <list> , <range> 
<range> : := SID 1 SID - SID 

SID, the SCCS Identification of a delta, may be 
in any form shown in the 'SID Specified' column 
of Table 1. Partial SIDs are interpreted as 
shown in the 'SID Retrieved' column of Table 1. 

-x list A list of deltas to be excluded (forced not to be 

applied) in the creation of the generated file. 
See the -i keyletter for the list format. 
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-^ Suppresses replacement of identification keywords 

(see below) in the retrieved text by their value. 
The -k keyletter is implied by the -e keyletter . 

-Ifp] Causes a delta summary to be written into an 1- 

file. If -Ip is used then an 1- file is not 
created; the delta summary is written on the 
standard output instead. See FILES for the for- 
mat of the 1- file . 

-P Causes the text retrieved from the SCCS file to 

be written on the standard output. No g- file is 
created. All output which normally goes to the 
standard output goes to file descriptor 2 
instead, unless the -s keyletter is used, in 
which case it disappears. 

-s Suppresses all output normally written on the 

standard output. However, fatal error messages 
(which always go to file descriptor 2) remain 
unaffected . 

-"1 Causes each text line retrieved from the SCCS 

file to be preceded by the SID of the delta that 

inserted the text line in the SCCS file. The 

format is: SID, followed by a horizontal tab, 
followed by the text line. 

-" Causes each generated text line to be preceded 

with the %H% identification keyword value (see 
below). The format is: %n% value, followed by a 
horizontal tab, followed by the text line. When 
both the -m and -n keyletters are used, the for- 
mat is: %H% value, followed by a horizontal tab, 
followed by the -m keyletter generated format. 

-g Suppresses the actual retrieval of text from the 

SCCS file. It is primarily used to generate an 
1- file , or to verify the existence of a particu- 
Tar~STD . 

-t Used to access the most recently created ('top') 

delta in a given release (e.g., -r1 ) , or release 
and level (e.g., -r1.2). 

- aseq -no. The delta sequence number of the SCCS file delta 
(version) to be retrieved (see sccsfile (5)) . 
This keyletter is used by the cornb(l) command; it 
is not a generally useful keyletter, and users 
should not use it. If both the -r and -a 
keyletters are specified, the -a keyletter is 
used. Care should be taken when using the -a 
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keyletter in conjunction with the -e keyletter, 
as the SID of the delta to be created may not be 
what one expects. The -r keyletter can be used 
with the -a and -e keyletters to control the nam- 
ing of the SID of the delta to be created. 

For each file processed, get responds (on the standard out- 
put) with the SID being accessed and with the number of 
lines retrieved from the SCCS file. 

If the -e keyletter is used, the SID of the delta to be made 
appears after the SID accessed and before the number of 
lines generated. If there is more than one named file or if 
a directory or standard input is named, each file name is 
printed (preceded by a new-line) before it is processed. If 
the -i keyletter is used included deltas are listed follow- 
ing the notation 'Included'; if the -x keyletter is used, 
excluded deltas are listed following the notation 
'Excluded' . 

TABLE 1. Determination of SCCS Identification String 

SID* -b Keyletter Other SID SID of Delta 

Specified Usedl Conditions Retrieved to be Created 

nonei no R defaults to mR mR.mL mR.(mL+1) 

nonet yes R defaults to mR mR.mL mR.mL. (mB+1 ). 1 

R no R > mR mR.mL R. 1*»* 

R no R = mR mR.mL mR.(mL+1) 

R yes R > mR mR.mL mR.mL. (mB+1 ). 1 

R yes R = mR mR.mL mR.mL. (mB+1 ). 1 

R < mR and 
R does not exist 
R - in release > R hR.mL** hR.mL. (mB+1 ) . 1 

and R exists 

R.L no No trunk succ . R.L R.(L+1) 

R.L yes No trunk succ. R.L R.L.(mB+1).1 

Trunk succ . 
R.L - in release >^ R R.L R.L. (mB+1). 1 

R.L.B no No branch succ. R.L.B.mS R.L.B.(mS+1) 
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R-L.B yes No branch succ . R.L.B.mS R.L.(mB+1).1 

R.L.B.S no No branch succ. R.L.B.S R.L.B.(S+1) 
^•^•^•S yes No branch succ. R.L.B.S R.L.(mB+1).1 
'^•L-B.S - Branch succ. R.L.B.S R . L. (mB+1 ) . 1 

* 'R', 'L', 'B', and 'S' are the 'release', 'level', 
'branch', and 'sequence' components of the SID, 
respectively; 'm' means 'maximum'. Thus, for example, 
'R.mL' means 'the maximum level number within release 
R'; 'R. L. (mB+1 ) . 1 ' means 'the first sequence number on 
the new branch (i.e., maximum branch number plus one) 
of level L within release R'. Note that if the SID 
specified is of the form 'R.L', 'R.L.B', or 'R.L.B.S', 
each of the specified components must exist. 

** 'hR' is the highest existing release that is lower 
than the specified, nonexistent , release R. 

*** This is used to force creation of the first delta in a 
new release . 

# Successor. 

■I- The -b keyletter is effective only if the b flag (see 

admin d )) is present in the file. An entry of - means 
' irrelevant' . 

This case applies if the d (default SID) flag is not 
present in the file. If the d flag j^ present in the 
file, then the SID obtained from the d flag is inter- 
preted as if it had been specified on the command 
line. Thus, one of the other cases in this table 
applies. 
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IDENTIFICATION KEYWORDS 

Identifying information is inserted into the text retrieved 
from the SCCS file by replacing identification keywords with 
their value wherever they occur. The following keywords may 
be used in the text stored in an SCCS file: 

Keyword Value 

W% Module name: either the value of the m flag in the 

file (see admin d )) , or if absent, the name of the 
SCCS file with the leading s. removed. 

%l% SCCS identification (SID) ilR%.%L%.%B%.%S%) of the 

retrieved text. 

%^% Release. 

%L% Level. 

%B% Branch. 

%S% Sequence. 

%D% Current date (YY/MM/DD). 
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%ti% Current date (MM/DD/YY). 

%1% Current time (HH:MM:SS). 

%E% Date newest applied delta was created (YY/MM/DD). 

%G% Date newest applied delta was created (MM/DD/YY). 

%U% Time newest applied delta was created (HH:MM:SS). 

%Y% Module type: value of the t flag in the SCCS file 

(see admin ( 1 )) . 
%F% SCCS file name. 

%?% Fully qualified SCCS file name. 

%Q% The value of the q flag in the file (see 

admin (1 )) . 
%C% Current line number. This keyword is intended for 

identifying messages output by the program such as 

'this shouldn't have happened' type errors. It is 

not intended to be used on every line to provide 

sequence numbers. 
%Z% The 4-character string @(#) recognizable by 

whatd ). 
XW% A shorthand notation for constructing what (1 ) 

strings for UNIX program files . 

%\i% = %Z%%M5S<horizontal-tab>%I% 
%k% Another shorthand notation for constructing 

what d ) strings for non-UNIX program files. 

IST~= %Z%%Y% %H% %IWZ% 

FILES 

Several auxiliary files may be created by get , These files 
are known generically as the g- file , 1- file , p- file , and z- 
file . The letter before the hyphen is called the tag. An 
auxiliary file name is formed from the SCCS file name: the 
last component of all SCCS file names must be of the form 
s. module - name , the auxiliary files are named by replacing 
the leading s with the tag. The g- file is an exception to 
this scheme: the g- file is named by removing the s. prefix. 
For example, s.xyz.c, the auxiliary file names would be 
xyz.c, l.xyz.c, p.xyz.c, and z.xyz.c, respectively. 

The g- file , which contains the generated text, is created* in 
the current directory (unless the -p keyletter is used). A 
g- file is created in all cases, whether or not any lines of 
text were generated by the get . It is owned by the real 
user. If the -k keyletter is used or implied its mode is 
644; otherwise its mode is 444. Only the real user need 
have write permission in the current directory. 

The 1- file contains a table showing which deltas were 
applied in generating the retrieved text. The 1- file is 
created in the current directory if the -1 keyletter is 
used; its mode is 444 and it is owned by the real user. 
Only the real user need have write permission in the current 
directory. 
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Lines in the 1- file have the following format: 



a . 
b. 

c . 



A 
* 



blank character 

otherwise . 
A blank character 
wasn' t applied and 

if the delta 



if the delta was applied; 

was applied or 



if the delta 

ignored; 

wasn't applied and wasn't 

a 'special' reason why 



d. 
e . 
f . 
g. 

h. 
i . 



A code indicating 

was or was not apblied: 

•I': Included. 

'X': Excluded. 

'C: Cut off (by a -c keyletter) 
Blank. 

sees identification (SID). 
Tab character . 
Date and time ( in the form 
creation . 
Blank. 
Login name of pergon who created 



ignored . 
the delta 



YY/MM/DD HH:MM:SS) of 



delta 



The comments and MR data follow on subsequent lines 



indented one horizontal 
terminates each entry. 



tab character. A blank line 



The p- file is used to pass |. 
with an -e keyletter along 
used to prevent a subsequen 
keyletter for the same S 
joint edit flag, j, ( see ad 
The p- file is created in 
file and the effective user 
that directory. Its mod^ 



effective user . 
SID, followed 
delta will have 
lowed by the 
blank, followed 
lowed by a blank 
present, followed by 



The format 
by a blank, 
when it is t^ 
login name 
by the datef 
and the 
a blank 



if it was present, followec^ 
arbitrary number of lines irti 
lines can have the same new 



nformation resulting from a get 

to delta . Its contents are also 

execution of get with an -e 

D until delta is executed or the 

_in(1)) is set in the SCCS file. 

he directory containing the SCCS 

must have write permission in 

is 644 and it is owned by the 

of the p- file is: the gotten 

followed by the SID that the new 

ade, followed by a blank, fol- 

of the real user , followed by a 

time the get was executed, fol- 

-i keyletter argument if it was 

and the -x keyletter argument 

by a new-line. There can be an 

the p- file at any time; no two 

delta SID. 



The z- file serves as a lock - out mechanism against simultane- 
ous updates. Its contents are the binary (2 bytes) process 
ID of the command (i.e., get ) that created it. The z-file 
is created in the directory containing the SCCS file for the 
duration of get . The same protection restrictions as those 
for the p- file apply for the z-file 
mode 444. 



The z-file is created 
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SEE ALSO 

adtnin(l), delta(l), help(l), prs(1), what(1), sccsfile(5). 
Source Code Control System User ' s Guide by L. E. Bonanni and 
C. A. Salemi. 

DIAGNOSTICS 

Use help d ) for explanations. 

RESTRICTIONS 

If the effective user has write permission (either expli- 
citly or implicitly) in the directory containing the SCCS 
files, but the real user doesn't, then only one file may be 
named when the -e keyletter is used. 
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NAME 



graph - draw a graph 



SYNOPSIS 

graph [ option ] ... 

DESCRIPTION 

Graph with no options takes pairs of nxombers from the stan- 
dard input as abscissas and ordinates of a graph. Succes- 
sive points are connected by straight lines. The graph is 
encoded on the standard output for display by the plot(l) 
filters. 

If the coordinates of a point are followed by a nonnumeric 
string, that string is printed as a label beginning on the 
point. Labels may be surrounded with quotes "...", in which 
case they may be empty or contain blanks and numbers; labels 
never contain newlines. 

The following options are recognized, each as a separate 
argument. 

-a Supply abscissas automatically (they are missing from 
the input); spacing is given by the next argument 
(default 1). A second optional argument is the start- 
ing point for automatic abscissas (default or lower 
limit given by -x). 



-b 



-c 



Break (disconnect) the graph after each label in the 
input. 

Character string given by next argument is default 
label for each point. 



frame with 



-1 
-m 



Next argument is grid style, no grid, 1 
ticks, 2 full grid (default). 

Next argument is label for graph. 

Next argument is mode (style) of connecting lines: 
disconnected, 1 connected (default). Some devices give 
distinguishable line styles for other small integers. 

-s Save screen, don't erase before plotting. 

-x [ 1 ] 

If 1 is present, x axis is logarithmic. Next 1 (or 2) 
arguments are lower (and upper) x limits. Third argu- 
ment, if present, is grid spacing on x axis. Normally 
these quantities are determined automatically. 
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-y [ 1 ] 

Similarly for y- 

-h Next argument is fraction of space for height. 

-w Similarly for width. 

-r Next argument is fraction of space to move right before 
plotting. 

-u Similarly to move up before plotting. 

-t Transpose horizontal and vertical axes. (Option -x now 
applies to the vertical axis.) 

A legend indicating grid range is produced with a grid 
unless the -s option is present. 

If a specified lower limit exceeds the upper limit, the axis 
is reversed. 

SEE ALSO 

spline(l), plot(l) 

RESTRICTIONS 

Graph stores all points internally and drops those for which 
there isn't room. 

Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 

grep, egrep, fgrep - search a file for a pattern 

SYNOPSIS 

grep [ option ] ... expression [ file ] ... 

egrep [ option ] ... [ expression ] [ file ] ... 

fgrep [ option ] ... [ strings ] [ file ] 

DESCRIPTION 

Commands of the grep family search the input files (standard 
input default) for lines matching a pattern. Normally, each 
line found is copied to the standard output; unless the -h 
flag is used, the file name is shown if there is more than 
one input file. 

Grep patterns are limited regular expressions in the style 
of ed(l); it uses a compact nondeterministic algorithm. 
Egrep patterns are full regular expressions; it uses a fast 
deterministic algorithm that sometimes needs exponential 
space. Fgrep patterns are fixed strings; it is fast and 
compact . 

The following options are recognized. 

-V All lines but those matching are printed. 

-c Only a count of matching lines is printed. 

-1 The names of files with matching lines are listed 
(once) separated by newlines. 



-n 



Each line is preceded by its line number in the file. 



-b Each line is preceded by the block number on which it 
was found. This is sometimes useful in locating disk 
block numbers by context. 

-s No output is produced, only status. 

-h Do not print filename headers with output lines. 

-y Lower case letters in the pattern will also match upper 
case letters in the input ( grep only) . 

-e expression 

Same as a simple expression argument, but useful when 
the expression begins with a -. 
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-f file 

The regular expression ( egrep ) or string list ( fgrep ) 
is taken from the file . 

-X (Exact) only lines matched in their entirety are 
printed ( fgrep only) . 

Care should be taken when using the characters $ * [ '^ I ? ' 
" ( ) and \ in the expression as they are also meaningful to 
the Shell. It is safest to enclose the entire expression 
argument in single quotes ' ' . 

Fgrep searches for lines that contain one of the (newline- 
separated) strings . 

Egrep accepts extended regular expressions. In the follow- 
ing description 'character' excludes newline: 

A \ followed by a single character matches that charac- 
ter. 

The character ^ ($) matches the beginning (end) of a 

line. 

A . matches any character. 

A single character not otherwise endowed with special 
meaning matches that character. 

A string enclosed in brackets [] matches any single 
character from the string. Ranges of ASCII character 
codes may be abbreviated as in 'a-zO-9', A ] may occur 
only as the first character of the string. A literal - 
must be placed where it can't be mistaken as a range 
indicator. 

A regular expression followed by * (+, ?) matches a 
sequence of or more (1 or more, or 1) matches of 
the regular expression. 

Two regular expressions concatenated match a match of 
the first followed by a match of the second. 

Two regular expressions separated by I or newline match 
either a match for the first or a match for the second. 

A regular expression enclosed in parentheses matches a 
match for the regular expression. 

The order of precedence of operators at the same parenthesis 
level is [] then *+? then concatenation then I and newline. 
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SEE ALSO 

ed(l), sed(l), sh(l) 

DIAGNOSTICS 

Exit status is if any matches are found, 1 if none, 2 for 
syntax errors or inaccessible files. 

RESTRICTIONS 

Ideally there should be only one grep , but we don't know a 
single algorithm that spans a wide enough range of space- 
time tradeoffs. 

Lines are limited to 256 characters; longer lines are trun- 
cated. 
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NAME 

help - ask for help 

SYNOPSIS 

help [args] 

DESCRIPTION 

Help finds information to explain a message from a command 
or explain the use of a command. Zero or more arguments may 
be supplied. If no arguments are given, help will prompt 
for one. 

The arguments may be either message numbers (which normally 
appear in parentheses following messages) or command names, 
of one of the following types: 

type 1 Begins with non-numerics, ends in numer- 
ics. The non-numeric prefix is usually 
an abbreviation for the program or set 
of routines which produced the message 
(e.g., ge6, for message 6 from the ge t 
command). 

type 2 Does not contain numerics (as a command, 
such as get) 

type 3 Is all numeric (e.g., 212) 

The response of the program will be the explanatory informa- 
tion related to the argument, if there is any. 

When all else fails, try 'help stuck'. 

FILES 

/usr/lib/help directory containing files of message 

text. 

DIAGNOSTICS 

Use help (l) for explanations. 
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NAME 



hostname - set or print name of current host system 



SYNOPSIS 

hostname [ nameofhost ] 

DESCRIPTION 

The hostname command prints the name of the current host, as 
given before the 'login' prompt. The super-user can set the 
hostname by giving an argument; this is usually done in the 
startup script /etc/rc. 

SEE ALSO 

ghostname(2) 
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NAME 



icheck - file system storage consistency check 



SYNOPSIS 

icheck [ 



-s ] [ -b numbers ] filesystem 



DESCRIPTION 

Icheck examines a file system, builds a bit map of used 
blocks, and compares this bit map against the free list 
maintained on the file system. If the file system is not 
specified, a set of default file systems is checked. The 
normal output of icheck includes a report of 

The total number of files and the numbers of regular, 
directory, block special and character special files. 

The total number of blocks in use and the numbers of 
single-, double-, and triple-indirect blocks and direc- 
tory blocks. 



The number of free blocks. 

The number of blocks missing; 
in the free list. 



i.e. not in any file nor 



The -s option causes icheck to ignore the actual free list 
and reconstruct a new one by rewriting the super-block of 
the file system. The file system should be dismounted while 
this is done; if this is not possible (for example if the 
root file system has to be salvaged) care should be taken 
that the system is quiescent and that it is rebooted immedi- 
ately afterwards so that the old, bad in-core copy of the 
super-block will not continue to be used. Notice also that 
the words in the super-block which indicate the size of the 
free list and of the i-list are believed. If the super- 
block has been curdled these words will have to be patched. 
The -s option causes the normal output reports to be 
suppressed. 

Following the -b option is a list of block numbers; whenever 
any of the named blocks turns up in a file, a diagnostic is 
produced. 

Icheck is faster if the raw version of the special file is 
used, since it reads the i-list many blocks at a time. 



FILES 

There is no default file system name. 

SEE ALSO 

dcheck(l), ncheck(l), filsys(5), clri{l), fsck(l) 
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DIAGNOSTICS 

For duplicate blocks and bad blocks (which lie outside the 
file system) icheck announces the difficulty, the i-number, 
and the kind of block involved. If a read error is encoun- 
tered, the block number of the bad block is printed and 
icheck considers it to contain 0. 'Bad freeblock' means 
that a block number outside the available space was encoun- 
tered in the free list. 'n dups in free' means that n 
blocks were found in the free list which duplicate blocks 
either in some file or in the earlier part of the free list. 

RESTRICTIONS 

Since icheck is inherently two-pass in nature, extraneous 
diagnostics may be produced if applied to active file sys- 
tems. 

It believes even preposterous super-blocks and consequently 
can get core images. 

The f sck (1) command provides a more comprehensive file sys- 
tem check. 
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NAME 



iostat - report I/O statistics 



SYNOPSIS 

iostat [ option ] 



[ drive ] 



[ interval [ count ] ] 



DESCRIPTION 

Iostat delves into the system and reports certain statistics 
kept about input-output activity. Information is kept about 
up to nine different types of disks (HP, HM, HJ, HK, RP, RL, 
RK, HS, RA) and about typewriters. The RA disks include the 
RX50 floppy disk (RX), the RD51 Winchester disk (RD), and 
the RC25 disk. 

For each disk drive, I/O completions and number of words 
transferred are counted; for typewriters collectively, the 
number of input and output characters are counted. Also, 
each sixtieth of a second, the state of each disk drive is 
examined and a tally is made if the disk drive is active. 
The processor state is also examined, this tally goes into 
one of four categories, depending on whether the system is 
executing in user mode, in 'nice' (background) user mode, in 
system mode, or idle. 

The iostat reports are for all types of activity, seeks as 
well as data transfers, on all drives that have had any I/O 
activity since the system was booted, inactive and nonex- 
istent drives are ignored. 

The optional drive argument allows the reports to be limited 
to a specified subset of the available drives. Up to six 
drive names, of the form; hpO, hml, rl3, rp4 , rdl, ra2, 
etc., may be specified. Reports will be generated for only 
those drives which exist and have been active. 

The optional interval argument causes iostat to report once 
^^^^ interval seconds. The first report is for all time 
since a reboot and each subsequent report is for the last 
interval only. 

The optional count argument restricts the number of reports. 
If count is given, then interval must also be specified. 

With no option argument iostat reports for each disk the 
number of transfers per minute, the milliseconds per average 
seek, and the milliseconds per data transfer exclusive of 
seek time. It also gives the percentage of time the system 
has spend in each of the four categories mentioned above. 

The following options are available: 

-t Report the number of characters of terminal 10 per 
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second as well. 

-i Report the percentage of time spend in each of the four 
categories mentioned above, the percentage of time each 
disk controller was active (seeking or transferring, 
the percentage of time any disk drive was active, and 
the percentage of time spent in '10 wait:' idle, but 
with a disk drive active. 

-s Report the raw timing information for each active disk 
drive. The information consists of; the disk con- 
troller name and drive number, the disk's transfer rate 
(microseconds/word) , the percentage of the total system 
time that the drive had I/O activity, the number of 
transfers on that drive, and the number of words 
transferred by the drive. 

-b Report on the usage of I/O buffers. The report gives; 
the number of buffers in the pool, the number of buf- 
fered reads, number of read-ahead blocks, number of 
buffer cache hits, number of buffered writes, and the 
number of I/O operations on each buffer starting with 
the first one. 

-d Print the date and time at the head of the report. 

-a Print the total time in minutes at the end of the 
report. 

FILES 

/dev/mem - system memory 
/unix - namelist 

RESTRICTIONS 

The accuracy of the iostat reports is subject to the six- 
tieth of a second granularity of the system clock. 

All disk I/O statistics produced by iostat are approximate, 
the RA disk statistics are more approximate than others. 
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NAME 

ipatch - print/modify contents of an inode 

SYNOPSIS 

/etc/ipatch filesystem inode 

DESCRIPTION 

Ipatch is an interactive program which allows the super-user 
to print and/or modify the contents of an inode. Filesystem 
is the name of the special file for the file system contain- 
ing the inode to be patched and inode is the number of the 
inode to be patched. Printing inodes may be done freely, 
but patching should be done only on dismounted file systems. 

Once invoked, the ipatch program prints a '.' prompt, indi- 
cating that it is ready to execute one of the following com- 
mands : 

q Quit, exit from ipatch. 

p Print the contents of the inode. 

w Write the patched inode out to the file system. 

The following ipatch commands require numbers as arguments. 
If the first digit of a number is zero it is interpreted as 
octal, otherwise as decimal. 

f # Change the inode flags to #. 

1 # Change the link count to #. 

u # Change the user ID to #. 

g # Change the group ID to #. 

s # Change the file size to # bytes. 

a #addr # Change the contents of the element of the 
inode' s address array, specified by #addr, to #. 

FILES 

There is no default file system name. 

SEE ALSO 

clri(l), ncheck(l), icheck(l), fsck(l) 

DIAGNOSTICS 

Ipatch prints '?' if it cannot execute a command. 

RESTRICTIONS 

Can be very dangerous if not properly used. 
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NAME 

join - relational database operator 

SYNOPSIS 

join [ options ] filel file2 

DESCRIPTION 

Join forms, on the standard output, a join of the two rela- 
tions specified by the lines of filel and f ile2 . If filel 
is '-', the standard input is used. 

Filel and f ile2 must be sorted in increasing ASCII collating 
sequence on the fields on which they are to be joined, nor- 
mally the first in each line. 

There is one line in the output for each pair of lines in 
filel and f ile2 that have identical join fields. The output 
line normally consists of the common field, then the rest of 
the line from filel , then the rest of the line from f ile2 . 

Fields are normally separated by blank, tab or newline. In 
this case, multiple separators count as one, and leading 
separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produce a line for 
each unpairable line in file n, where n is 1 or 2. 

-e s Replace empty output fields by string s. 

-jn m 

Join on the mth field of file n. If n is missing, use 
the mth field in each file. 

-o list 

Each output line comprises the fields specified in 
list , each element of which has the form n.m, where n 
IS a file number and m is a field number. 

-tc Use character c as a separator (tab character). Every 
appearance of c in a line is significant. 

SEE ALSO 

sort(l), comm(l), awk(l) 

RESTRICTIONS 

With default field separation, the collating sequence is 
that of sort -b; with -t, the sequence is that of a plain 
sort. 
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The conventions of join , sort , comm , uniq , look and awk(l) 
are wildly incongruous. 



KILL(l) KILL(l) 



NAME 

kill - terminate a process with extreme prejudice 

SYNOPSIS 

kill [ -signo ] processid ... 

DESCRIPTION 

Kill sends signal 15 (terminate) to the specified processes. 
If a signal number preceded by '-' is given as first argu- 
ment, that signal is sent instead of terminate (see sig- 
nal (2) ) . This will kill processes that do not catch the 
signal; in particular 'kill -9 ...' is a sure kill. 

By convention, if process number is specified, all members 
in the process group (i.e. processes resulting from the 
current login) are signaled. 

The killed processes must belong to the current user unless 
he is the superuser. To shut the system down to single user 
mode use the operator services program. Refer to Chapter 5 
of the ULTRIX - 11 System Management Guide for operator ser- 
vices program information. 

The process number of an asynchronous process started with 
•&• is reported by the shell. Process numbers can also be 
found by using ps(l) . 

SEE ALSO 

ps(l), kill(2), signal(2) 
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NAME 

Id - loader 

SYNOPSIS 

Id [ option ] file ... 

DESCRIPTION 

Ld combines several object programs into one, resolves 
external references, and searches libraries. In the sim- 
plest case several object files are given, and Id combines 
them, producing an object module which can be either exe- 
cuted or become the input for a further 1 run. (In the 
latter case, the -r option must be given to preserve the 
relocation bits.) The output of Id is left on a. out. This 
file is made executable only Tf no errors occurred during 
the load. 

The overlay loader is used for the generation of the overlay 
text unix kernel and user overlay programs. 

The argument routines are concatenated in the order speci- 
fied. The entry point of the output is the beginning of the 
first routine. 

If any argument is a library, it is searched exactly once at 
the point it is encountered in the argument list. Only 
those routines defining an unresolved external reference are 
loaded. If a routine from a library references another rou- 
tine in the library, and the library has not been processed 
by ranlib (l) , the referenced routine must appear after the 
referencing routine in the library. Thus the order of pro- 
grams within libraries may be important. If the first 
member of a library is named ' .SYMDEF', then it is under- 
stood to be a dictionary for the library such as produced by 
ranlib ; the dictionary is searched iteratively to satisfy as 
many references as possible. 

The symbols '_etext', '_edata' and •_end' {'etext', 'edata' 
and 'end' in C) are reserved, and if referred to, are set to 
the first location above the program, the first location 
above initialized data, and the first location above all 
data respectively. It is erroneous to define these symbols. 

Ld understands several options. Except for -1, they should 
appear before the file names. 

-s 'Strip' the output, that is, remove the symbol table 
and relocation bits to save space (but impair the use- 
fulness of the debugger). This information can also be 
removed by strip (l) . 

-u Take the following argument as a symbol and enter it as 
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undefined in the symbol table. This is useful for 
loading wholly from a library, since initially the sym- 
bol table is empty and an unresolved reference is 
needed to force the loading of the first routine. 

-Ix This option is an abbreviation for the library name 
Vlib/libx.a' , where x is a string. If that does not 
exist. Id tries ' /usr/lib/libx.a' . A library is 
searched when its name is encountered, so the placement 
of a -1 is significant. 

-x Do not preserve local (non-.globl) symbols in the out- 
put symbol table; only enter external symbols. This 
option saves some space in the output file. 

-X Save local symbols except for those whose names begin 
with 'L'. This option is used by cc(l) to discard 
internally generated labels while retaining symbols 
local to routines. 

-r Generate relocation bits in the output file so that it 
can be the subject of another Id run. This flag also 
prevents final definitions from being given to common 
symbols, and suppresses the 'undefined symbol' diagnos- 
tics. 

-d Force definition of common storage even if the -r flag 
is present. 

-n Arrange that when the output file is executed, the text 
portion will be read-only and shared among all users 
executing the file. This involves moving the data 
areas up to the first possible 4K word boundary follow- 
ing the end of the text. 

-i When the output file is executed, the program text and 
data areas will live in separate address spaces. The 
only difference between this option and -n is that here 
the data starts at location 0. 

-o The name argument after -o is used as the name of the 
Id output file, instead of a. out. 

-e The following argument is taken to be the name of the 
entry point of the loaded program; location is the 
default. 

-0 This is an overlay file. This option will cause the 
entire text segment of a running process to be overlaid 
, retaining the current data segment, when exec (2) is 
called. Shared data must have the same layout as in 
the program overlaid. 
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-D The next argument is a decimal number that sets the 
size of the data segment. 

-Z Marks the beginning of an overlay text segment. The 
object modules listed up to the next -Z or -L option 
are placed in the next overlay (nxjmerically) . 

-L Marks the end of all overlays. Any further routines or 
libraries go into the base segment. 

FILES 

/lib/lib*. a libraries 

/usr/lib/lib*.a more libraries 

a. out output file 

SEE ALSO 

as(l), ar(l), cc{l), f77(l), ranlib(l) 

RESTRICTIONS 

The -0 option is untested and probably does not work. 
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NAME 

learn - computer aided instruction about UNIX 

SYNOPSIS 

learn [ -directory ] [ subject [ lesson [ speed ] ] ] 

DESCRIPTION 

Learn gives CAI courses and practice in the use of UNIX. To 
get started simply type 'learn'. The program will ask ques- 
tions to find out what you want to do. The questions may be 
bypassed by naming a subject , and the last lesson number 
that learn told you in the previous session. You may also 
include a s peed number that was given with the lesson number 
(but without the parentheses that learn places around the 
speed number). If lesson is '-', learn prompts for each 
lesson; this is useful for debugging. 

The subjects presently handled are 

editor 

eqn 

files 

macros 

moref iles 

C 

The special command 'bye' terminates a learn session. 

The - directory option allows one to exercise a script in a 
nonstandard place. 

FILES 

/usr/lib/learn and all dependent directories and files 

RESTRICTIONS 

The main strength of learn , that it asks the student to use 
the real UNIX, also makes possible baffling mistakes. It is 
helpful, especially for nonprogrammers, to have a UNIX ini- 
tiate near at hand during the first sessions. 

Occasionally lessons are incorrect, sometimes because the 
local version of a command operates in a non-standard way. 
Such lessons may be skipped, but it takes some sophistica- 
tion to recognize the situation. 
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NAME 

lex - generator of lexical analysis programs 

SYNOPSIS 

lex [ -tvfn ] [ file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analysis 
of text. The input files (standard input default) contain 
regular expressions to be searched for, and actions written 
in C to be executed when expressions are found. 

A C source program, 'lex.yy.c' is generated, to be compiled 
thus: 

cc lex.yy.c -11 

This program, when run, copies unrecognized portions of the 
input to the output, and executes the associated C action 
for each regular expression that is recognized. 

The following lex program converts upper case to lower, 
removes blanks at the end of lines, and replaces multiple 
blanks by single blanks. 

%% 

[A-Z] putchar(yytext[0]+'a'-'A' ) ; 

[ ]+$ 

[ ]+ putcharC '); 

The options have the following meanings. 

-t Place the result on the standard output instead of in 
file ' lex.yy.c' . 

-V Print a one-line siammary of statistics of the generated 
analyzer. 

-n Opposite of -v; -n is default. 

-f 'Faster' compilation: don't bother to pack the result- 
ing tables; limited to small programs. 

SEE ALSO 

yacc(l) 

M. E. Lesk and E. Schmidt, LEX - Lexical Analyzer Generator 
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NAME 

lint - a C program verifier 

SYNOPSIS 

lint [ -abchnpuvx ] file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files 
which are likely to be bugs, or non-portable, or wasteful. 
It also checks the type usage of the program more strictly 
than the compilers. Among the things which are currently 
found are unreachable statements, loops not entered at the 
top, automatic variables declared and not used, and logical 
expressions whose value is constant. Moreover, the usage of 
functions is checked to find functions which return values 
in some places and not in others, functions called with 
varying numbers of arguments, and functions whose values are 
not used. 

By default, it is assumed that all the files are to be 
loaded together; they are checked for mutual compatibility. 
Function definitions for certain libraries are available to 
lint; these libraries are referred to by a conventional 
name, such as '-Im', in the style of ld(l). 

Any number of the options in the following list may be used. 
The -D, -U, and -I options of cc(l) are also recognized as 
separate arguments. 

p Attempt to check portability to the IBM and GCOS 
dialects of C. 

h Apply a number of heuristic tests to attempt to intuit 
bugs, improve style, and reduce waste. 

b Report break statements that cannot be reached. (This 
is not the default because, unfortunately, most lex and 
many yacc outputs produce dozens of such commentsTT 



V Suppress complaints about unused arguments in func- 
tions. 

X Report variables referred to by extern declarations, 
but never used. 

a Report assignments of long values to int variables. 

c Complain about casts which have questionable portabil- 
ity. 



u 



Do not complain about functions and variables used and 
not defined, or defined and not used (this is suitable 
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for running lint on a subset of files out of a larger 
program) . 

n Do not check compatibility against the standard 
library. 

Exit (2) and other functions which do not return are not 
understood; this causes various lies. 

Certain conventional comments in the C source will change 
the behavior of lint ; 

/*NOTREACHED*/ 

at appropriate points stops comments about unreachable 
code. 

/*VARARGSn*/ 

suppresses the usual checking for variable numbers of 
arguments in the following function declaration. The 
data types of the first n arguments are checked; a 
missing n is taken to be 0. 

/*NOSTRICT*/ 

shuts off strict type checking in the next expression. 

/*ARGSUSED*/ 

turns on the -v option for the next function. 

/*LINTLIBRARY*/ 

at the beginning of a file shuts off complaints about 
unused functions in this file. 

FILES 

/usr/lib/lint[12] programs 

/usr/lib/llib-lc declarations for standard functions 

/usr/lib/llib-port declarations for portable functions 

SEE ALSO 
cc(l) 
S. C. Johnson, Lint , a C Program Checker 
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NAME 

In - make a link 

SYNOPSIS 

In [ -f ] namel [ name2 ] 

DESCRIPTION 

A link is a directory entry referring to a file; the same 
file (together with its size, all its protection informa- 
tion, etc.) may have several links to it. There is no way 
to distinguish a link to a file from its original directory 
entry; any changes in the file are effective independently 
of the name by which the file is known. 

The -f option allows the super-user to link to a directory. 

Ln creates a link to an existing file namel . If name2 is 
given, the link has that name; otherwise it is placed in the 
current directory and its name is the last component of 
namel . 

It is forbidden to link across file systems. 

SEE ALSO 

rm(l) 
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NAME 

login - sign on 

SYNOPSIS 

login [ username ] 

DESCRIPTION 

The login command is used when a user initially signs on, or 
it may be used at any time to change from one user to 
another. The latter case is the one summarized above and 
described here. See 'How to Get Started' for how to dial up 
initially. 

If login is invoked without an argument, it asks for a user 
name, and, if appropriate, a password. Echoing is turned 
off (if possible) during the typing of the password, so it 
will not appear on the written record of the session. 

After a successful login, accounting files are updated and 
the user is informed of the existence of . mail and message- 
of-the-day files. Login initializes the user and group IDs 
and the working directory, and sets the HOME, PATH, TERM, 
SHELL and USER environment variables. It then executes a 
command interpreter (usually sh(l) or csh( 1) ) according to 
specifications found in a password file. If the command 
interpreter is / bin /csh, the new line discipline is entered, 
otherwise the terminal stop characters are set to be unde- 
fined (see stty (l) ) . Argument of the command interpreter 
starts with a ' -' . 

Login is recognized by sh(l) and csh(l) and executed 
directly (without forking). 

FILES 

/etc/utmp accounting 

/usr/adm/wtmp accounting 

/usr/mail/* mail 

/etc/motd message-of-the-day 

/etc/passwd password file 

SEE ALSO 

init(8), newgrp(l), getty(8), mail(l), passwd(l), passwd(5) 

DIAGNOSTICS 

'Login incorrect,' if the name or the password is bad. 

'No Shell', 'cannot open password file', 'no directory': 

consult a programming counselor. 
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NAME 

logins - enable user logins 
nologins - disable user logins 

SYNOPSIS 

logins 
nologins 

DESCRIPTION 

The logins and nologins conunands allow the super-user to 
selectively enable and disable user logins. The super-user 
may login as 'root' on any terminal even when logins are 
disabled. 

FILES 

/etc/loglock disables user logins 
/etc/sdloglock system shutdown in progress 

SEE ALSO 

login(l), shutdown(8) 

DIAGNOSTICS 

'No Logins', a user attempted to login while logins were 
disabled. 

'LOGINS DISABLED', printed when the super-user logs in and 
user logins are disabled. 
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NAME 

look - find lines in a sorted list 

SYNOPSIS 

look [ -df ] string [ file ] 

DESCRIPTION 

Look consults a sorted file and prints all lines that begin 
with string . It uses binary search. 

The options d and f affect comparisons as in sort (1) ; 

d 'Dictionary' order: only letters, digits, tabs and 
blanks participate in comparisons. 

f Fold. Upper case letters compare equal to lower case. 

If no file is specified, / usr / dict / words is assumed with 
collating sequence -df. 

FILES 

/usr/dict /words 

SEE ALSO 

sort(l), grep(l) 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file ... 

DESCRIPTION 

The input is one or more object or library archive (see 
ar(l)) files . The standard output is a list of pairs of 
object file names, meaning that the first file of the pair 
refers to external identifiers defined in the second. The 
output may be processed by tsort(l) to find an ordering of a 
library suitable for one-pass access by ld(l). 

This brash one-liner intends to build a new library from 
existing ' .o' files. 

ar cr library 'lorder *.o I tsort' 

FILES 

*symref, *symdef 

nm(l), sed(l), sort(l), join(l) 

SEE ALSO 

tsort(l), ld(l), ar(l) 

RESTRICTIONS 

The names of object files, in and out of libraries, must end 
with '.o'; nonsense results otherwise. 
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NAME 

Ipq - show lineprinter queue 

SYNOPSIS 

Ipq [ option ] [ job_nunibers ... ] [ user_names ... ] 

DESCRIPTION 

Lpq displays the files that are queued for printing on a 
line printer. Any job numbers or user names entered with 
the command will limit the output to jobs with the appropri- 
ate job numbers or that have been printed by the users whose 
names were given. The following option s are available: 

-1 Display the queue with a long format. 

-Pprinter Display the queue for printer printer . 

FILES 

/usr/spool/lpd/lock 
/usr/spool/lpd/cf* data file 
/usr/spool/lpd/df * daemon control file 
/usr/spool/lpd/tf * temporary version of control file 

SEE ALSO 

Ipq(l), Iprm(l), printcap(5), lpd(8), ulf(8) 
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NAME 



Ipr - line printer spooler 



SYNOPSIS 

Ipr [ option ] ... [ file ] ... 

DESCRIPTION 

Lpr causes the file s to be queued for printing on a line 
printer. If no files are named, the standard input is read. 
The following option s are available: 

Remove the file when it has been queued. 

Copy the file to insulate against changes that 
may happen before printing. 

Report by ma i 1 ( 1 ) when printing is complete. 

Print name instead of file name on header page. 

Pipe each file through gr before printing it. 

Use name instead of file name on pr's header. 

Use name instead of hostname on header. 

Indent output nn spaces (8 if just -i). 

Print nn copies of each file. 

Route output to alternate printer printer . 



-r 
-c 

-m 
-Jname 

-P 

-hname 

-Cname 

-inn 

-#nn 

-Pprinter 



FILES 

/usr/spool/lpd/lock 
/usr/spool/lpd/cf* data file 
/usr/spool/lpd/df* daemon control file 
/usr/spool/lpd/tf* temporary version of control file 
/usr/adm/lpacct accounting records 

SEE ALSO 

Ipq(l), Iprmd), printcap(5), lpd(8), ulf(8) 
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NAME 

Iprm - delete jobs from the lineprinter queue 

SYNOPSIS 

Iprm [ option ] [ job_numbers ... ] [ user_names ... ] 

DESCRIPTION 

Lprm deletes the file s from the print queue. Lprm will 
attempt to delete members whose job niombers or user names 
have been entered with the command. No one except the 
super-user may remove another user's files. The following 
option s are available: 

Delete all jobs owned by the issuer of the com- 
mand. 

-Pprinter Delete jobs from the queue of the alternate 
printer printer . 

FILES 

/usr/spool/lpd/lock 
/usr/spool/lpd/cf * data file 
/usr/spool/lpd/df* daemon control file 
/usr/spool/lpd/tf * temporary version of control file 

SEE ALSO 

Ipq(l), Iprm(l), printcap(5), lpd(8), ulf(8) 
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NAME 

Ipset - set line printer parameters 

SYNOPSIS 

/etc/lpset [-r] 

/etc/lpset flag ind line col 

DESCRIPTION 

The Ipset command with no arguments displays the current 
printer parameter values. Only the super-user may execute 
Ipset , The printer must be quiescent when Ipset is executed. 

The -- option resets the parameters to the default values 
(flag = 0, ind = 0, line = 66, col = 132). 

The parameters may be changed by specifying the new value of 
each parameter to Ipset , as follows: 

flag Flag bits are set by oring their value with the flag 
argument. 

The FFCLOSE (010) flag causes a page eject on LP 
close. This flag is normally reset, because the 
spooler l£r(l) ejects a page after each file is 
printed. 

The CAP (020) should be set for 64-character set 
printers, uppercase only. 

ind Number of character spaces to indent from the left 
margin. 

line Number of lines to print per page. 

col The column width, i.e., number of characters per 
line. 

Parameter changes may be made automatically by including the 
Ipset command in the /etc/rc file. 

FILES 

/unix - system namelist 
/dev/ Lp - printer special file 

SEE ALSO 

Ipr(l), lp(4), lpd(8), init(8) 

DIAGNOSTICS 

Error messages will be printed if a parameter value is out 
of range, the printer file (/dev/lp) cannot be opened, or 
the printer is active. 
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NAME 

Is - list contents of directory 

SYNOPSIS 

Is [ -abcdfgilmqrstuxlCFR ] name ... 

DESCRIPTION 

For each directory argument. Is lists the contents of the 
directory; for each file argument. Is repeats its name and 
any other information requested. The output is sorted 
alphabetically by default. When no argument is given, the 
current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but 
file argviments appear before directories and their contents. 

There are three major listing formats. The format chosen 
depends on whether the output is going to a teletype, and 
may also be controlled by option flags. The default format 
for a teletype is to list the contents of directories in 
multi-column format, with the entries sorted down the 
columns. (Files which are not the contents of a directory 
being interpreted are always sorted across the page rather 
than down the page in columns. This is because the indivi- 
dual file names may be arbitrarily long.) If the standard 
output is not a teletype, the default format is to list one 
entry per line. Finally, there is a stream output format in 
which files are listed across the page, separated by ' , ' 
characters. The -m flag enables this format; when invoked 
as I this format is also used. 

There are an unbelievable number of options: 

-1 List in long format, giving mode, number of links, 
owner, size in bytes, and time of last modification for 
each file. (See below.) If the file is a special file 
the size field will instead contain the major and minor 
device numbers. 

-t Sort by time modified (latest first) instead of by 
name, as is normal. 

-a List all entries; usually '.' and '..' are suppressed. 

-s Give size in blocks, including indirect blocks, for 
each entry. 

-d If argument is a directory, list only its name, not its 
contents (mostly used with -1 to get status on direc- 
tory) . 



-r 



Reverse the order of sort to get reverse alphabetic or 
oldest first as appropriate. 
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-u 



-1 



-X 
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Use time of last access instead of last modification 
for sorting (-t) or printing (-1). 



-c Use time of file creation for sorting or printing. 



Print i-number in first column of the report for each 
file listed. 



-f Force each argument to be interpreted as a directory 
and list the name found in each slot. This option 
turns off -1, -t, -s, and -r, and turns on -a; the 
order is the order in which entries appear in the 
directory. 

-g Give group ID instead of owner ID in long listing, 
-m force stream output format 

-1 force one entry per line output format, e.g. to a tele- 
type 

-C force multi-column output, e.g. to a file or a pipe 

-q force printing of non-graphic characters in file names 
as the character '?'; this normally happens only if the 
output device is a teletype 

-b force printing of non-graphic characters to be in the 
\.ddd notation, in octal. 



force columnar printing to be sorted across rather than 
down the page; this is the default if the last charac- 
ter of the name the program is invoked with is an 'x'. 

-F cause directories to be marked with a trailing '/' and 

executable files to be marked with a trailing '*'• this 

IS the default if the last character of the name the 
program is invoked with is a 'f. 

-R recursively list subdirectories encountered. 

The mode printed under the -1 option contains 11 characters 
which are interpreted as follows: the first character is 

d if the entry is a directory; 

b if the entry is a block-type special file; 

c if the entry is a character-type special file; 

if the entry is a multiplexor-type character special 

t lie; 

if the entry is a plain file. 



m 



r 


if 


the 


w 


if 


the 


X 


if 


the 


- 


if 


the 



LS(1) LS(1) 



The next 9 characters are interpreted as three sets of three 
bits each. The first set refers to owner permissions; the 
next to permissions to others in the same user-group; and 
the last to all others. Within each set the three charac- 
ters indicate permission respectively to read, to write, or 
to execute the file as a program. For a directory, 'exe- 
cute' permission is interpreted to mean permission to search 
the directory for a specified file. The permissions are 
indicated as follows: 

file is readable; 

file is writable; 

file is executable; 

indicated permission is not granted. 

The group-execute permission character is given as s if the 
file has set-group-ID mode; likewise the user-execute per- 
mission character is given as s if the file has set-user-ID 
mode. 

The last character of the mode (normally 'x' or '-') is t if 
the 1000 bit of the mode is on. See chmod (l) for the mean- 
ing of this mode. 

When the sizes of the files in a directory are listed, a 
total count of blocks, including indirect blocks is printed. 

FILES 

/etc/passwd to get user ID's for 'Is -1'. 
/etc/group to get group ID's for 'Is -g'. 

RESTRICTIONS 

Newline and tab are considered printing characters in file 
names. 

The output device is assumed to be 80 columns wide. 

The option setting based on whether the output is a teletype 
is undesirable as ''Is -s' ' is much different than 
' ' Is -s I Ipr' ' . On the other hand, not doing this setting 
would make old shell scripts which used j^ almost certain 
losers. 

Column widths choices are poor for terminals which can tab. 
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NAME 

mil - Macro-11 assembler for UNIX 

SYNOPSIS 

mil [ optionl option2 ... ] filel file2 ... filen 

DESCRIPTION 

Mil assembles the concatenation of the specified files 
TTTlel, etc.) and terminates when an '.end' statement is 
encountered. The resulting object file is usually named 
filen . obi (see below). If a file argument, f ilei does not 
contain a '.' in its name, the file filei.mll will be sought 
before f ilei itself. 

Options, if desired, may appear anywhere in the command, and 
are choSen from the following list. All options are inter- 
preted before any files are read. 

-Is Produce an assembly listing and place in filen . 1st 

-It Produce an assembly listing on the standard output. 

-fl If coupled with the -Is or -It directives, makes the 
listing have a shortened format. It is shorthand for 
"111 • seg : loc : biji : bex : me : m^ : t^ : toe : s^ 

-uc Simulate an initial .d sabl Ic directive. Force all 

characters in macro definitions to be upper case. This 

flag makes lower-case handling in mil compatible with 
the DEC Macro-11 assemblers. 

-urn Force all characters in macro definitions to be upper 
case. This flag makes lower-case handling in this 
release of mil compatible with previous versions of 
mil . 

-de Make all option choices needed to make assembly mimic 
DEC Macro-11. Implies ( inter alia) the -uc flag. This 
includes the Johns Hopkins asm assembler. 

-ha Make all option choices needed to make assembly mimic 
earlier (Harvard) releases of mil. This implies the 
-umflag. Default .psect and .csect attributes are set 
up in the funny Harvard way. 

-mx Produce a listing of the source program as it appears 
after macro expansion. Macro calls, conditional direc- 
tives and so on appear in the listing as comments. 
Listing appears on standard output. No machine code is 
generated or listed. This option is meant to 
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correspond to the -E or -P options of the C compiler 
cc(l) . 

-my Like -mx, except that macro calls and conditional 
directives do not show up in the listing. 

-10 Generate an error whenever op codes not in the PDP-11 
'standard instruction set' are encountered. Program- 
mers writing for a PDP 11/10 can catch instructions 
illegal for that machine by using this argument. 

-dp:args 

The default attributes for a . psect or unnamed . csect 
are redefined, using the colon-separated list args of 
valid .psect attributes. 

-da: args 

The default attributes for an . asect are redefined. 

-dp:c 

The default attributes for a named .csect are rede- 
fined. 

-li:arglist 

Simulate an initial . list arglist directive. All . list 
and . nlist directives in the program text which attempt 
to change the settings established with the -}A flag 
will be ignored. 

-nltarglist 

Like - li l arglist , but for the . nlist directive. 

-en:arglist 

Similarly, for the . enabl directive. 

-ds:arglist 

Similarly, but for the .dsabl directive. 

-crtarglist 

Produces a cross-reference listing. If the -Is option 
is also included, the cross-reference listing will fol- 
low the assembly listing in f ilen . 1st. References 
which are tagged with the symbol # are definitions. 
References tagged with * are destructive references: 
the value of the symbol or variable in question is 
changed. Arglist consists of colon-separated keywords 
from the following set. The keywords may be prefix 
abbreviated: 

sym All user-defined symbols are indexed. 

mac All macro names are indexed. 
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per All uses of permanent symbols - op codes, direc- 
tives, etc - are indexed. 

pse All psect names are indexed. For compatibility 
with the RT-11 CREF program, the argument cse is 
synonymous with pse . 

err All errors are indexed, 

reg All register uses are indexed. 

If no arglist is specified the default sym ; mac ; err is 
used. In the listing page and line numbers for uses of 
symbols are followed by a # sign if the symbol is 
defined and by a * sign if the symbol is modified. 

-Ip Same as -Is, but also spools f ilen .lst for printing 
upon completion. 

-no No object file is produced. This is useful for syntax 
checking or list producing. 

-xs:n 

Allots nK words of extra space for symbol table and 
macro storage. NOTE: This option is currently inopera- 
tive: mil automatically allots core for its tables as 
needed. 

-XX Debug flag: generate all kinds of weird hack flack. 

-ns No symbol table is included in the object file (thus 
ddt knows of no symbols from this assembly). 

-sx Make the symbol table contain 'local symbols' as well 
as ordinary symbols. 

-u Treat form feed characters as spaces. This will make 
inll's idea of line numbers coincide with the UNIX text 
editors. Macro-11 statements containing imbedded form 
feed characters will be parsed differently when the -u 
flag is in effect. "" 

-na: file 

Override the convention of using last name as file 
name. Instead, use names f ile . obj and file . 1st for 
object and listing files. 

NOTES 

This implementation of Macro-11 is a distant hand-me down 
from an old DEC Macro-11 modified at Harvard University in 
the early 1970 's. It is grubby with smudges by Brent Byer, 
F. J. Howard, Bob Bower ing, and Jim Reeds. It does not 
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implement keyword arguments such as are described in section 
7.3.6 of the DEC manual. The .enabl abs option does not 
work. Listing control is by default .list ttm. Unlike ear- 
lier editions of mil at UCB and at Harvard, it does treat 
immediate constants of floating point operations correctly: 
see the last paragraph of section 6.4.2 on the middle of 
page 6-27 of the DEC manual. Mil has several directives not 
described in the DEC manual. See the New UCB Mil Manual . 
The default attributes for . psects are different from those 
described in the DEC manual, but may be changed by the - dp 
flag. The .enabl gib feature is implemented: undefined sym- 
bols are taken as undefined global externals. 

FILES 

/usr/lib/sysmac.sml system macro library 

(for .mcall directive) 
filen.xrf intermediate cross-reference 

temporary file 
Ipr(l) spooler 

/usr/ucb/macxrf cross-reference post-processor 

SEE ALSO 

PDP -11 MACRO - 11 Language Reference Manual , Digital Equip- 
ment Corp. Order No. AA-5075A-TC, August 1977. 
New UCB Mil Manual , notional document by Jim Reeds. 
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NAME 

m4 - macro processor 

SYNOPSIS 

m4 [ files ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Rat for, 
C, and other languages. Each of the argument files is pro- 
cessed in order; if there are no arguments, or if an argu- 
ment is '-', the standard input is read. The processed text 
is written on the standard output. 

Macro calls have the form 

name(argl,arg2, . . . , argn) 

The '(' must immediately follow the name of the macro. If a 
defined macro name is not followed by a '(', it is deemed to 
have no arguments. Leading unquoted blanks, tabs, and new- 
lines are ignored while collecting arguments. Potential 
macro names consist of alphabetic letters, digits, and 
underscore '_' , where the first character is not a digit. 

Left and right single quotes ('') are used to quote strings. 
The value of a quoted string is the string stripped of the 
quotes. 

When a macro name is recognized, its arguments are collected 
by searching for a matching right parenthesis. Macro 
evaluation proceeds normally during the collection of the 
arguments, and any commas or right parentheses which happen 
to turn up within the value of a nested call are as effec- 
tive as those in the original input text. After argument 
collection, the value of the macro is pushed back onto the 
input stream and rescanned. 

M4 makes available the following built-in macros. They may 
be redefined, but once this is done the original meaning is 
lost. Their values are null unless otherwise stated. 

define The second argument is installed as the value of 
the macro whose name is the first argument. Each 
occurrence of $n in the replacement text, where n 
is a digit, Ts replaced by the n-th argument. 
Argument is the name of the macro; missing argu- 
ments are replaced by the null string. 

undefine removes the definition of the macro named in its 
argument . 

ifdef If the first argument is defined, the value is the 
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second argument, otherwise the third. If there is 
no third argument, the value is null. The word 
Unix is predefined on UNIX versions of m4. 

changequote 

Change quote characters to the first and second 
arguments. Changequote without arguments restores 
the original values (i.e., ''). 

divert M4 maintains 10 output streams, numbered 0-9. The 
final output is the concatenation of the streams 
in numerical order; initially stream is the 
current stream. The divert macro changes the 
current output stream to its (digit-string) argu- 
ment. Output diverted to a stream other than 
through 9 is discarded. 

undivert causes immediate output of text from diversions 
named as arguments, or all diversions if no argu- 
ment. Text may be undiverted into another diver- 
sion. Undiverting discards the diverted text. 

divnum returns the value of the current output stream. 

dnl reads and discards characters up to and including 
the next newline. 

if else has three or more arguments. If the first argu- 
ment is the same string as the second, then the 
value is the third argument. If not, and if there 
are more than four arguments, the process is 
repeated with arguments 4, 5, 6 and 7. Otherwise, 
the value is either the fourth string, or, if it 
is not present, null. 



incr 



returns the value of its argument incremented by 
1. The value of the argument is calculated by 
interpreting an initial digit-string as a decimal 
number. 



eval 



len 
index 

substr 



evaluates its argument as an arithmetic expres- 
sion, using 32-bit arithmetic. Operators include 
+ , -, *, /, %, '^ (exponentiation); relationals; 
parentheses. 

returns the number of characters in its argument. 

returns the position in its first argument where 
the second argument begins (zero origin), or -1 if 
the second argument does not occur. 



returns a substring of its first argument, 



The 
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second argument is a zero origin number selecting 
the first character; the third argument indicates 
the length of the substring. A missing third 
argument is taken to be large enough to extend to 
the end of the first string. 

translit transliterates the characters in its first argu- 
ment from the set given by the second argument to 
the set given by the third. No abbreviations are 
permitted. 

include returns the contents of the file named in the 
argument. 

sinclude is identical to include , except that it says noth- 
ing if the file is inaccessible. 

syscmd executes the UNIX command given in the first argu- 
ment. No value is returned. 

maketemp fills in a string of XXXXX in its argument with 
the current process id. 

errprint pjrints its argument on the diagnostic output file. 

dumpdef prints current names and definitions, for the 
named items, or for all if no arguments are given. 

SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The M4 Macro Processor 
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NAME 

mail - send and receive mail 

SYNTAX 

mail [ -V ] [ -i ] [ -n ] [ -s subject ] [ user ... ] 

mail [ -V ] [ -i ] [ -n ] -f [ name ] 

mail [ -V ] [ -i ] [ -n ] -u user 

INTRODUCTION 

Mail is a intelligent mail processing system, which has a 
command syntax reminiscent of ed with lines replaced by mes- 
sages. 

The -V flag puts mail into verbose mode; the details of 
delivery are displayed on the users terminal. The -i flag 
causes tty interrupt signals to be ignored. This is particu- 
larly useful when using mail on noisy phone lines. The -n 
flag inhibits the reading of /usr/lib/Mail. re. 

Sending mail . To send a message to one or more other peo- 
ple, mail can be invoked with arguments which are the names 
of people to send to. You are then expected to type in your 
message, followed by an EOT (control-D) at the beginning of 
a line. A subject may be specified on the command line by 
using the -s flag. (Only the first argument after the -s 
flag is used as a subject; be careful to quote subjects con- 
taining spaces.) The section below, labeled Replying to or 
originating mail , describes some features of mail available 
to help you compose your letter. 

Reading mail . In normal usage mail is given no arguments 
and checks your mail out of the post office, then prints out 
a one line header of each message there. The current mes- 
sage is initially the first message (numbered 1) and can be 
printed using the print command (which can be abbreviated 
p) . You can move among the messages much as you move 
between lines in ed, either with the commands '+' and "-' 
moving backwards and forwards or with simple numbers. 

Disposing of mail . After examining a message you can delete 
(d) the message or reply (r) to it. Deletion causes the 
mail program to forget about the message. This is not 
irreversible; the message can be undeleted (u) by giving its 
number, or the mail session can be aborted by giving the 
exit (x) command. Deleted messages will, however, usually 
disappear never to be seen again. 

Specifying messages . Commands such as print and delete can 
be given a list of message numbers as arguments to apply to 
a number of messages at once. Thus ""delete 1 2'' deletes 
messages 1 and 2, while ""delete 1-5'' deletes messages 1 
through 5. The special name ""*'' addresses all messages. 
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and ^^$'' addresses the last message; thus the command top 
which prints the first few lines of a message could be used 
in ^^top *'' to print the first few lines of all messages. 

Replying to or originating mail . You can use the reply com- 
mand to set up a response to a message, sending it back to 
the person who it was from. Text you then type in, up to an 
end-of-file, defines the contents of the message. While you 
are composing a message, mail treats lines beginning with 
the character '-' specially. For instance, typing ^^~m'' 
(alone on a line) will place a copy of the current message 
into the response right shifting it by a tabstop. Other 
escapes will set up subject fields, add and delete reci- 
pients to the message and allow you to escape to an editor 
to revise the message or to a shell to run some commands. 
(These options are given in the summary below.) 



Ending a mail processing session . You can end a mail ses- 
sion with the qu i t ( q ) command. Messages which have been 
examined go to your mbox file unless they have been deleted 
in which case they are discarded. Unexamined messages go 
back to the post office. The -f option causes mail to read 
in the contents of your mbox (or the specified file) for 
processing; when you quit, mail writes undeleted messages 
back to this file. The -u flag is a short way of doing 
"mail -f /usr/spool/mail/user". 

Personal and systemwide distribution lists . It is also pos- 
sible to create a personal distribution lists so that, for 
instance, you can send mail to ''cohorts'' and have it go to 
a group of people. Such lists can be defined by placing a 
line like 

alias cohorts bill ozalp jkf mark kridle@ucbcory 

in the file .mailrc in your home directory. The current 
list of such aliases can be displayed with the alias (a) 
command in mail . System wide distribution lists can be 
created by editing /usr/lib/aliases, see aliases (5) and 
sendmaiK S) ; these are kept in a different syntax. In mail 
you send, personal aliases will be expanded in mail sent to 
others so that they will be able to reply to the recipients. 
System wide aliases are not expanded when the mail is sent, 
but any reply returned to the machine will have the system 
wide alias expanded as all mail goes through sendmail . 

Network mail ( ARPA , UUCP , Berknet ) See mailaddr (7) for a 
description of network addresses. 

Mail has a number of options which can be set in the .mailrc 
file to alter its behavior; thus ''set askcc'' enables the 
''askcc'' feature. (These options are summarized below.) 
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SUMMARY 

(Adapted from the 'Mail Reference Manual') 

Each command is typed on a line by itself, and may take 
arguments following the command word. The command need not 
be typed in its entirety - the first command which matches 
the typed prefix is used. For commands which take message 
lists as arguments, if no message list is given, then the 
next message forward which satisfies the command's require- 
ments is used. If there are no messages forward of the 
current message, the search proceeds backwards, and if there 
are no good messages at all, mail types ''No applicable mes- 
sages'' and aborts the command. 

Goes to the previous message and prints it out. 
If given a numeric argument n, goes to the n-th 
previous message and prints it. 

? Prints a brief summary of commands. 

! Executes the UNIX shell command which follows. 

Print (P) Like print but also prints out ignored 
header fields. See also print and ignore. 

Reply (R) Reply to originator. Does not reply to other 
recipients of the original message. 

Type (T) Identical to the Print command. 

alias (a) With no arguments, prints out all 
currently-defined aliases. With one argument, 
prints out that alias. With more than one argu- 
ment, creates an new or changes an on old alias. 
These aliases are in effect for the current mail 
session only. 

alternates (alt) The alternates command is useful if you 
have accounts on several machines. It can be 
used to inform mail that the listed addresses 
are really you. When you reply to messages, mail 
will not send a copy of the message to any of 
the addresses listed on the alternates list. If 
the alternates command is given with no argu- 
ment, the current set of alternate names is 
displayed. 

chdir (ch ) Changes the user's working directory to 
that specified. If no directory is given, then 
changes to the user's login directory. 

copy (co) The copy command does the same thing that 
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save does, except that it does not mark the mes- 
sages it is used on for deletion when you quit. 

delete (d) Takes a list of messages as argument and 
marks them all as deleted. Deleted messages 
will not be saved in mbox , nor will they be 
available for most other commands. 

^P (also dt) Deletes the current message and prints 

the next message. If there is no next message, 
mail says at EOF. ' ' 

S'^it (e) Takes a list of messages and points the text 
editor at each one in turn. On return from the 
editor, the message is read back in. 

®xit (ex or x) Effects an immediate return to the 
Shell without modifying the user's system mail- 
box, his mbox file, or his edit file in -f. 

file (fi) The same as folder. 

folders List the names of the folders in your folder 
directory. 

folder (fo) The folder command switches to a new mail 
file or folder. With no arguments, it tells you 
which file you are currently reading. If you 
give it an argument, it will write out changes 
(such as deletions) you have made in the current 
file and read in the new file. Some special con- 
ventions are recognized for the name. # means 
the previous file, % means your system mailbox, 
%user means user's system mailbox, & means your 
~/mbox file, and +f older means a file in your 
folder directory. 

fj^oni (f) Takes a list of messages and prints their 
message headers in the order that they appear in 
the mail directory, not in the order given in 
the list. 

headers (h) Lists the current range of headers, which is 
an 18 message group. If a ''+'' argument is 
given, then the next 18 message group is 
printed, and if a ''-'' argument is given, the 
previous 18 message group is printed. 

help A synonym for ? 

^old (ho, also preserve) Takes a message list and 
marks each message therein to be saved in the 
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user's system mailbox instead of in mbox . Does 
not override the delete command. 

ignore Add the list of header fields named to the 
ignored list . Header fields in the ignore list 
are not printed on your terminal when you print 
a message. This command is very handy for 
suppression of certain machine-generated header 
fields. The Type and Print commands can be used 
to print a message in its entirety, including 
ignored fields. If ignore is executed with no 
arguments, it lists the current set of ignored 
fields. 

mail (m) Takes as argument login names and distribu- 
tion group names and sends mail to those people. 

mbox Indicate that a list of messages be sent to mbox 
in your home directory when you quit. This is 
the default action for messages if you do not 
have the hold option set. 

next (n like + or CR) Goes to the next message in 
sequence and types it. With an argument list, 
types the next matching message. 

preserve (pre) A synonym for hold. 

print (p) Takes a message list and types out each mes- 
sage on the user's terminal. 

quit (q) Terminates the session, saving all 
undeleted, unsaved messages in the user's mbox 
file in his login directory, preserving all mes- 
sages marked with hold or preserve or never 
referenced in his system mailbox, and removing 
all other messages from his system mailbox. If 
new mail has arrived during the session, the 
message ''You have new mail'' is given. If 
given while editing a mailbox file with the -f 
flag, then the edit file is rewritten. A return 
to the Shell is effected, unless the rewrite of 
edit file fails, in which case the user can 
escape with the exit command. 

reply (r) Takes a message list and sends mail to the 
sender and all recipients of the specified mes- 
sage. The default message must not be deleted. 

respond A synonym for reply. 

save (s) Takes a message list and a filename and 
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set 



shell 



size 



source 
top 

type 
unalias 

undelete 

unset 

visual 

write 
xit 

z 



appends each message to the end of the file. The 
messages are saved in the order in which they 
appear in the mail directory, not in that given 
in the message list. The filename in quotes, 
followed by the line count and character count 
is echoed on the user's terminal. 



(se) With 
values 
of the f 



no arguments, 



prints all variable 

Otherwise, sets option. Arguments are 

orm ^ "option=value' ' or ""option.'' 



(sh) Invokes 
shell. 



opt: 
an interactive version of the 



Takes a message list and prints out the size (in 
characters) of each message. The size of the 
messages are printed in the order that they 
appear in the mail directory, not in that given 
in the list. 

(so) The source command reads mail commands from 
a file. 

Takes a message list and prints the top few 
lines of each. The number of lines printed is 
controlled by the variable toplines and defaults 
to five. 

(t) A synonym for print. 

Takes a list of names defined by alias commands 
and discards the remembered groups of users. 
The group names no longer have any significance. 

(u) Takes a message list and marks each one as 
not being deleted. 

Takes a list of option names and discards their 
remembered values; the inverse of set. 

(v) Takes a message list and invokes the display 
editor on each message. 

(w) A synonym for save. 

(x) A synonym for exit. 

Mail presents message headers in windowfuls as 
described under the headers command. You can 
move mail 's attention forward to the next window 
with the z command. Also, you can move to the 
previous window by using z-. 
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Here is a summary of the tilde escapes, which are used when 
composing messages to perform special functions. Tilde 
escapes are only recognized at the beginning of lines. The 
name ^^tilde escape'' is somewhat of a misnomer since the 
actual escape character can be set by the option escape. 

~! command Execute the indicated shell command, then return 
to the message. 

~c name ... Add the given names to the list of carbon copy 
recipients. 

-d Read the file ' 'dead. letter' ' from your home 
directory into the message. 

~e Invoke the text editor on the message collected 

so far. After the editing session is finished, 
you may continue appending text to the message. 

~f messages Read the named messages into the message being 
sent. If no messages are specified, read in the 
current message. 

~h Edit the message header fields by typing each 
one in turn and allowing the user to append text 
to the end or modify the field by using the 
current terminal erase and kill characters. 

~m messages Read the named messages into the message being 
sent, shifted right one tab. If no messages are 
specified, read the current message. 

~p Print out the message collected so far, prefaced 
by the message header fields. 

~q Abort the message being sent, copying the mes- 
sage to ' 'dead. letter' ' in your home directory 
if save is set. 

~r filename Read the named file into the message. 

~s string Cause the named string to become the current 
subject field. 

~t name ... Add the given names to the direct recipient 
list. 

~v Invoke an alternate editor (defined by the 

VISUAL option) on the message collected so far. 
Usually, the alternate editor will be a screen 
editor. After you quit the editor, you may 
resume appending text to the end of your 
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message. 
~w filename Write the message onto the named fil 



e. 



~ I command 



-string 



Pipe the message through the command as a 
filter. If the command gives no output or ter- 
minates abnormally, retain the original text of 
the message. The command fmt(l) is often used 
as command to rejustify the message. 

Insert the string of text in the message pre- 
faced by a single ~. if you have changed the 
escape character, then you should double that 
character in order to send it. 



Options are controlled via the set and unset commands. 
Options may be either binary, in which case it is only sig- 
nificant to see whether they are set or not, or strinq in 
which case the actual value is of ' 
options include the following: 



interest. The binary 



append 



Causes messages saved in mbox to be 
to the end rather than prepended. 
set in /usr/lib/Mail.rc on version 
terns. ) 



appended 

(This is 

7 sys- 



ask 



Causes mail to 
each message 
simply a newline, 
sent. 



prompt you for the subject of 

you send. If you respond with 

no subject field will be 



askcc 



autoprint 



debug 



dot 



hold 



Causes you to be prompted for additional car- 
bon copy recipients at the end of each mes- 
sage. Responding with a newline indicates 
your satisfaction with the current list. 

Causes the delete command to behave like dp - 
thus, after deleting a message, the next one 
will be typed automatically. 

Setting the binary option debug is the same 
as specifying -d on the command line and 
causes mail to output all sorts of informa- 
tion useful for debugging mail . 

The binary option dot causes mail 
pret a period alone on a line as 
tor of a message you are sending. 



to inter- 
the termina- 



This option is used to hold messages 
system mailbox by default. 



in the 
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ignore 
ignoreeof 

msgprompt 
metoo 



nosave 



quiet 
verbose 



Causes interrupt signals from your terminal 
to be ignored and echoed as @'s. 

An option related to dot is ignoreeof which 
makes mail refuse to accept a control-d as 
the end of a message. Ignoreeof also applies 
to mail command mode. 

When sending mail, prompts you for the mes- 
sage text and indicates how to terminate the 
message. 

Usually, when a group is expanded that con- 
tains the sender, the sender is removed from 
the expansion. Setting this option causes 
the sender to be included in the group. 

Normally, when you abort a message with two 
RUBOUT, mail A copies the partial letter to 
the file dead. letter ' ' in your home direc- 
tory. Setting the binary option nosave 
prevents this. 

Suppresses the printing of the version when 
first invoked. 

Setting the option verbose is the same as 
using the -v flag on the command line. When 
mail runs in verbose mode, the actual 
delivery of messages is displayed on he users 
terminal. 



The following options have string values: 
EDITOR 



SHELL 



VISUAL 



crt 



escape 



Pathname of the text editor to use in the 
edit command and ~e escape. If not defined, 
then a default editor is used. 

Pathname of the shell to use in the ! command 
and the ~! escape. A default shell is used 
if this option is not defined. 

Pathname of the text editor to use in the 
visual command and ~v escape. 

The valued option crt is used as a threshold 
to determine how long a message must be 
before more is used to read it. 

If defined, the first character of this 
option gives the character to use in the 
place of ~ to denote escapes. 
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folder 



record 



toplines 



FILES 



The name of the directory to use for storing 
folders of messages. If this name begins with 
a /', mail considers it to be an absolute 
pathname; otherwise, the folder directory is 
found relative to your home directory. 

If defined, gives the pathname of the file 
used to record all outgoing mail. If not 
defined, then outgoing mail is not so saved. 

If defined, gives the number of lines of a 
message to be printed out with the top com- 
mand; normally, the first five lines are 
printed. 



/usr/spool/mail/* 

~/mbox 

~/. mail re 

/tmp/R# 

/usr/1 ib/Mai 1 . help* 

/usr/1 ib/Mai 1 . re 

Message* 



post office 

your old mail 

file giving initial mail commands 

temporary for editor escape 

help files 

system initialization file 

temporary for editing messages 



SEE ALSO 

binmaild), from(l) 

^The Mail Reference Manual' 
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NAME 

mail - send or receive mail among users 

SYNOPSIS 

/bin/mail person ... 

mail [ -r ] [ -q ] [ -p ] [ -f file ] 

DESCRIPTION 

Mail with no argument prints a user's mail, message-by- 
message, in last-in, first-out order; the optional argument 
-r causes first-in, first-out order. If the -p flag is 
given, the mail is printed with no questions asked; other- 
wise, for each message, mail reads a line from the standard 
input to direct disposition of the message. 

newline 

Go on to next message. 

d Delete message and go on to the next. 

p Print message again. 

Go back to previous message. 

s [ file ] . . . 

Save the message in the named files Cmbox' default). 

w [ file ] ... 

Save the message, without a header, in the named files 
('mbox' default). 

m [ person ] . . . 

Mail the message to the named persons (yourself is 
default) . 

EOT (control-D) 

Put unexamined mail back in the mailbox and stop. 

q Same as EOT. 

X Exit, without changing the mailbox file. 

! command 

Escape to the Shell to do command. 

? Print a command summary. 

An interrupt stops the printing of the current letter. The 
optional argument -q causes mail to exit after interrupts 
without changing the mailbox. 
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When persons are named, mail takes the standard input up to 
an end-of-file (or a line with just '.') and adds it to each 
person 's 'mail' file. The message is preceded by the 
sender's name and a postmark. Lines that look like post- 
marks are prepended with '>'. a person is usually a user 
name recognized by loqin (l). To denote a recipient on a 
remote system, prefix person by the system name and exclama- 
tion mark (see uucp (l) K 

The -f option causes the named file, e.g. 'mbox' to be 
printed as if it were the mail file. 

Each user owns his own mailbox, which is by default gen- 
erally readable but not writable. The command does not 
delete an empty mailbox nor change its mode, so a user may 
make it unreadable if desired. 

When a user logs in he is informed of the presence of mail. 

FILES 

/usr/spool/mail/* mailboxes 

/etc/passwd to identify sender and locate persons 

mbox saved mail 

/tmp/ma* temp file 

dead. letter unmailable text 

uux ( 1 ) 

SEE ALSO 

xsend(l), write(l), uucp(l) 

RESTRICTIONS 

There is a locking mechanism intended to prevent two senders 
from accessing the same mailbox, but it is not perfect and 
races are possible. 
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NAME 



make - maintain program groups 



SYNOPSIS 
make 



[ -f makefile ] [ option ] 



file 



DESCRIPTION 

Make executes 
target nam es. 



in makefile 



commands 

Name is typically a 
is present, 'makefile' and 'Makefile' are 
If makefile is '-', the standard input is 
one -f option may appear 



to update one 
program. If no 
tried 
taken. 



or more 

-f option 

in order. 

More than 



Make updates a target if it depends on prerequisite files 
that have been modified since the target was last modified, 
or if the target does not exist. 

Makefile contains a sequence of entries that specify depen- 
dencies. The first line of an entry is a blank-separated 
list of targets, then a colon, then a list of prerequisite 
files. Text following a semicolon, and all following lines 
that begin with a tab, are shell commands to be executed to 
update the target. 

Sharp and newline surround comments. 

The following makefile says that 'pgm' depends 
'a.o' and 'b.o', and that they in turn depend 
and a common file 'incl'. 



on two files 
on ' .c' files 



pgm: a.o b.o 

cc a.o b.o -Im -o pgm 
a.o: incl a.c 

cc -c a.c 
b.o: incl b.c 

cc -c b.c 

Makefile entries of the form 

stringl = string2 

are macro definitions. Subsequent appearances of $( stringl ) 
are replaced by string2 . If stringl is a single character, 
the parentheses are optional. 



makefile gives 
file may be 



Make infers prerequisites for files for which 

no construction commands. For example, a '.c' 
inferred as prerequisite for a ' .o' file and be compiled to 
produce the '.o' file. Thus the preceding example can be 
done more briefly: 
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pgm: a.o b.o 

cc a.o b.o -Im -o pgm 
a.o b.o: incl 

Prerequisites are inferred according to selected suffixes 
listed as the 'prerequisites' for the special name '.SUF- 
FIXES'; multiple lists accumulate; an empty list clears what 
came before. Order is significant; the first possible name 
for which both a file and a rule as described in the next 
paragraph exist is inferred. The default list is 

.SUFFIXES: .out .o .c .e .r .f .y .1 .s 

The rule to create a file with suffix s2 that depends on a 
similarly named file with suffix si is specified as an entry 
for the 'target' sls2. In such an entry, the special macro 
$* stands for the target name with suffix deleted, $@ for 
the full target name, $< for the complete list of prere- 
quisites, and $? for the list of prerequisites that are out 
of date. For example, a rule for making optimized ' .o' 
files from '.c' files is 

.c.o: ; cc -c -0 -o $§ $*.c 

Certain macros are used by the default inference rules to 
communicate optional arguments to any resulting compila- 
tions. In particular, 'CFLAGS' is used for cc and f77(l) 
options, 'LFLAGS' and 'YFLAGS' for lex and yacc (l) options. 

Command lines are executed one at a time, each by its own 
shell. A line is printed when it is executed unless the 
special target '.SILENT' is in makefile , or the first char- 
acter of the command is '@'. 

Commands returning nonzero status (see intro (l) ) cause make 
to terminate unless the special target '.IGNORE' is in 
makefile or the command begins with <tab><hyphen>. 

Interrupt and quit cause the target to be deleted unless the 
target depends on the special name '.PRECIOUS'. 

Other options: 

-i Equivalent to the special entry '.IGNORE:'. 

-k When a command returns nonzero status, abandon work on 
the current entry, but continue on branches that do not 
depend on the current entry. 



-n 



Trace and print, but do not execute the commands needed 
to update the targets. 
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-t Touch, i.e. update the modified date of targets, 
without executing any commands. 

-r Equivalent to an initial special entry '.SUFFIXES:' 
with no list. 

-s Equivalent to the special entry '.SILENT:'. 

FILES 

makefile. Makefile 

SEE ALSO 

sh(l), touch(l) 

S. I. Feldman Make - A Program for Maintaining Computer Pro- 
grams 

RESTRICTIONS 

Some commands return nonzero status inappropriately. Use -i 
to overcome the difficulty. 

Commands that are directly executed by the shell, notably 
cd(l), are ineffectual across newlines in make . 
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NAME 

man - print sections of this manual 

SYNOPSIS 

man [ option ... ] [ chapter ] title ... 

DESCRIPTION 

Man locates and prints the section of this manual named 
title^ in the specified chapter . (in this context, the word 
page is often used as a synonym for 'section'.) The title 
is entered in lower case. The chapter number does not~Hi^d 
a letter suffix. if no chapter is specified, the whole 
manual is searched for title and all occurrences of it are 
printed. 

Options and their meanings are: 

-t Phototypeset the section using troff (1) . 

nroffdl^^ section on the standard output using 



-n 



-k Display the output on a Tektronix 4014 terminal using 
troff (1) and tc{l). ^ 

-e Appended or prefixed to any of the above causes the 
manual section to be preprocessed by neqn or eand)* -e 
alone means -te. — -^^ 



-w 



Print the path names of the manual sections, but do not 
print the sections themselves. 

(default) 

Copy an already formatted manual section to the termi- 
nal, or. If none is available, act as -n. It may be 
necessary to use a filter to adapt the output to the 
particular terminal's characteristics. 

Further options, e.g. to specify the kind of terminal you 
have are passed on to troff (1) or nroff. Options and 
chapter may be changed before each title . 

For example: 
man man 

would reproduce this section, as well as any other sections 
named man that may exist in other chapters of the manual 
e.g. man (7) . ' 
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FILES 

/usr/man/man?/* 
/usr/man/cat?/* 
/tmp/Man* 

SEE ALSO 

nroff(l), eqn(l), tc(l), man(7) 

RESTRICTIONS 

The manual is supposed to be reproducible either on a photo- 
typesetter or on a terminal. However, on a terminal some 
information is necessarily lost. 
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NAME 

memstat - print memory usage map 

SYNOPSIS 

memstat [ ifn ] [ interval ] [ corefile ] [ namelist ] 

DESCRIPTION 

The memstat program prints a map showing the utilization of 
all of memory. The optional argument 'i' specifies that the 
printout should be repeated every interval seconds. The 'f 
option causes corefile to be used as memory instead of 
/dev/mem. The 'n' option declares that the system namelist 
should be obtained from namelist instead of /unix. Single 
or multiple options may be specified. The arguments inter- 
val, corefile, and namelist must occur in the same order as 
the options [ifn] . 

The following headings appear on the memstat printout: 



Addr 
Command 

Pid 
Size 

Ublock 

Text 
Data 
Stack 



The octal address range of the section of memory 
being mapped. 

The name of the entity occupying a section of 
memory. This may be the operating system, a pro- 
cess, a shared text segment, or free memory. 

The process ID number of the process named in com- 
mand. 

The total size in bytes of non-shared text 
processes or the size of the data segment of 
shared text processes. 

The address and size of the U block (per process 
data) for the process. 

Size and address of the processes text segment. 
Size and address of the processes data segment. 
Size and address of the processes stack. 



FILES 



/unix - default system namelist 
/dev/mem - default system memory 

SEE ALSO 

Refer to the ULTRIX-11 System Management Guide, Section 
9.5.5 for an example of a memstat printout. 
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NAME 

mesg - permit or deny messages 

SYNOPSIS 

mesg [ n ] [ y 3 

DESCRIPTION , V ^ 

Mesg with argument n forbids messages via vrite (l) by revok- 
ing non-user write permission on the user's terminal. Mesg 
with argument y reinstates permission. All by itself, mes g 
reports the current state without changing it. 

FILES 

/dev/tty* 
/dev 

SEE ALSO 

write(l) 

DIAGNOSTICS 

Exit status is if messages are receivable, 1 if not, 2 on 

error. 



MKCONF(IM) 



MKCONF(IM) 



NAME 

mkconf - generate configuration tables 

SYNOPSIS 

mkconf <?.cf 

DESCRIPTION 

The mkconf program is a key part of the internal workings of 
the system generation process. Mkconf is called by the sys- 
tem generation program (sysgen) . The following documenta- 
tion of the mkconf program is for informational purposes 
only, refer to the ULTRIX-11 System Management Guide, 
Chapter 2 a description of the sysgen program and its usage. 



The mkconf program reads the (?.cf) 
file and creates the following files: 



system configuration 



l.s 
c.c 

mchO . s 
dds.h 
devmaj , 
ovload 



locore trap and interrupt vectors 
configuration tables 
machine language assist header file 
disk data structures header file 
major device number header file 
overlay kernel load shell file 



The configuration file contains device specifications 
system placement specifications, and system 
values. 



, file 
parameter 



The device specifications use the following format: 
#dev addr vector en 

where; # is the number of units, dev is the device mnemonic, 
addr IS the device hardware address, vector is its interrupt 
w™^'' ^J'^^ess, and en is the disk controller number for 
MSCP and MASSBUS disks. If addr and vector are omitted the 
standard device address and vector are used. 

The following device mnemonics will be accepted by mkconf 
not all are supported by the ULTRlX-11 system: 

ct (CAT - phototypesetter) 

Ip (LPll) 

dc (DCll) 

kl (KLll/DLll-ABCD) 

dl (DLll-E) 

dp (DPll) 

dn (DNll) 

dh (DHll) 

dhdm {DMll-BB) 

uh (DHUll/DHVll) 

du (Dull) 
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dz (DZll) 

dzv (DZVll/DZQll) 

ra (RA60/RA80/RA81) 

re (RC25) 

rq (RD51/RD52/RX50) 

hs (RS03/RS04) 

tk (reserved) 

rk (RK03/RK05) 

rl (RLOl/2) 

tm (TMll) 

rp (RP02/3) 

hp (RM02/3/5, RP04/5/6, MLll on first RH) 

hm (RM02/3/5, RP04/5/6, MLll on second RH) 

hj (RM02/3/5, RP04/5/6, MLll on third RH) 

hk (RK06/7) 

ht (TM02/3) 

ts (TS11/TSV05/TK25/TU80) 

hx (RX02) 

ul-4 user devices 

The following file system placement and parameter specifica- 
tions are also accepted: 

root dev minor 

The specified block device (e.g. hp) is used for the 
root. minor is a decimal number giving the minor dev- 
ice. This line must appear exactly once. 

pipe dev minor 

The specified block device is used to store pipes. If 
not given the root is used. 

swap dev minor 

The specified block device is used for swapping. If 
not given the root is used. 

swplo number 

nswap number 

Sets the origin (block number) and size of the area 
used for swapping. By default, the not very useful 
numbers 4000 and 800. 

eldev dev minor 

The specified block device (e.g. hp) is used for the 
error log. minor is a decimal number giving the minor 
device. 

elsb number 

elnb number 

Sets the origin (block number) and size of the area 
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NAME 

mkdir - make a directory 

SYNOPSIS 

mkdir dirname . . . 

DESCRIPTION 

Mkdir creates specified directories in mode 777. Standard 
entries, '.', for the directory itself, and '..' for its 
parent, are made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rm(l) 

DIAGNOSTICS 

Mkdir returns exit code if all directories were success- 
fully made. Otherwise it prints a diagnostic and returns 
nonzero. 
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used for the error log. 



dump dev 

Selects the crash dump device, i.e., disk, tape, or 

dumplo number 

dumphi number 

dumpdn number 

If the crash dump device is a disk, specifies the- 
starting block number, ending block number, and th4 
disk unit number for the crash dump area, normally 
located in the swap area. ^ 

ov Causes mkconf to create the file "ovload" which is used 

^y ^^^./J'^efile in /sys/conf to link the overlay 

ULTRIX-11 kernel. Must be specified if the overlay 

kernel is to be generated. ci xay 

parameter number 



Sets the specified parameter to number. Each parameter 
has a default value, which is used if the parameter is 
not specified. The valid parameters are; nbuf, ninode 
nfile, nmount, maxuprc, ncall, nproc, ntext, nclist! 
canbsiz, hz, timezone, dstflag, ncargs, maxseg 



msgbufs. 



FILES 



l.s, dds.h, devmaj.h, ovload, c.c, mchO.s - output file« 
?.cf - configuration input file 

SEE ALSO 

ULTRIX-11 System Management Guide, Chapter 2 
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NAME 

mkfs - construct a file system 
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SYNOPSIS 

/etc/mkfs special proto/size [ disk cpu ] [ fsname volname 1 
/etc/mkfs special proto/size [ m n ] [ fsname volname ] 

DESCRIPTION 



^constructs a file system by writing on the special file 
special according to the specification proto /size. Thl 
^roto/size specification is either a prototyfTTTlf^ntain- 
ing instructions on how to build the file system? or a 
number specifying the size of the file system. ^^''^""' °'^ ^ 

The prototype file contains tokens separated by spaces or 
new lines. The first token is the name of^a me ?o be 

^^l1t^ °"^S. ^^^^'^ ^^^° ^^ th« bootstrap program, sel 
boot(8). The second token is a number specifying th4 sizi 

of bLckf'on ' i' T'?"- ^ypi-^iiy it Sin L the nu^b" 

of blocks on the device, perhaps diminished by space for 
swapping. The next token is the number of i-nodes in the 
i-list. The next set of tokens comprise the specification 
for the root file. File specifications consist of tokenS 
giving the mode, the user-id, the group id, and the initial 

denenS^'on'.n'" ''.''' ^'" "^"^^^ °^ ^^^ contents ietd 
depends on the mode. 

The mode token for a file is a 6 character string. The 
first character specifies the type of the file (The char- 
acters -bed specify regular, block specia!, ch;racte? spe- 
cial and directory files respectively.) Th4 second character 
not T^r i^^i^^•' ^ ^'^ - to specify set-user- id mode or 
rtlt of^L l^^/ ■ '^ ?.°'' "J°r the set-group-id mode. The 
rest of the mode is a three digit octal number giving the 

s^e'^U)"' ^"' °'*^^^ '''^' ^''''' --"^- permissions? 

Two decimal number tokens come after the mode; they specify 
the user and group ID's of the owner of the file. ^P^'^^^Y 

If the file is a regular file, the next token is a pathname 
whence the contents and size are copied. patnname 

If the file is a block or character special file two 
device numberl? '°''"' '°''°" "^'"*^ ^'"" ^^^ "^^^°^ and'mino? 

^^^^^!u^^^® ^^ ^ directory, mkfs makes the entries . and 
and then reads a list of— Hames and (recursively) fii^ 
specifications for the entries in the directory. ?he scan 
IS terminated with the token $. ^ ^" 
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If the proto / size specification consists of a string of 
digits, mkfs builds a file system with a single empty direc- 
tory on It. The size of the file system is the value of 
proto / size interpreted as a decimal number. The number of 
i-nodes is calculated as a function of the file system size. 
The boot program is left uninitialized. 

The optional arguments m and n are the file system inter- 
leave factors , used for optimal free list spacing. If m 
and n are not specified, the values m = 9 and n = 500 are 
used. 

The preferred method of specifying optimal free list spacing 
is to allow mkfs to select the optimum values of m and n 
according to the type of disk and processor. The dTsk is 
the generic name of the disk (rl02, rp06, raSO, etc. ) and 
cpu is the number of the processor (23, 34, 44, etc.). 

The optional arguments fsname and volname are the file sys- 
tem and volume name labels to be recorded in the last 12 
characters of the superblock ( char fsname[6] , volname [6] ; ) . 
If fsname and volname are omitted, these fields are left 
uninitialized. The labelit ( lm ) command may be use to ini- 
tialize or change the fsname and volname labels after the 
file system has been created. Refer to volcopy ( lm ) for 
information on the labelit ( lm ) command. 

To create a file system on an RL02 disk, unit zero, the fol- 
lowing command would be used: 

/etc/mkfs /dev/rrl07 20480 rl02 23 /user users 

Refer to Appendix D of the ULTRIX - 11 System Management Guide 
for disk partition size and layout information for all sup- 
ported disks. 

A sample prototype specification follows: 

/usr/mdec/uboot 
4872 55 
d— 777 3 1 
usr d— 777 3 1 

sh 755 3 1 /bin/sh 

ken d— 755 6 1 
$ 

bO b~644 3 10 

cO c — 644 3 10 

$ 
$ 
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SEE ALSO 

filsys(5), dir(5), boot(8), volcopy(lm), 
ULTRIX-11 System Management Guide, Section 

RESTRICTIONS 

There should be some way to specify links. 



4.6 
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NAME 



mknod - build special file 



SYNOPSIS 

/etc/mknod name [ c ] [ b ] major minor 

DESCRIPTION 

Mknod makes a special file. The first argument is the name 
of the entry. The second is b if the special file is 
block-type (disks, tape) or c if it is character-type (other 
devices). The last two arguments are nximbers specifying the 
major device type and the minor device (e.g. unit, drive, or 
line number) . 

The assignment of major device numbers is specific to each 
system. They have to be dug out of the system source file 
conf .c. 



SEE ALSO 

mknod(2), csf(l) 
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NAME 



mkstr - create an error message file by massaging C source 



SYNTAX 

mkstr [ - ] messagefile prefix file ... 

DESCRIPTION 

Mkstr is used to create files of error messages. Its use 
can make programs with large numbers of error diagnostics 
much smaller, and reduce system overhead in running the pro- 
gram as the error messages do not have to be constantly 
swapped in and out. 

Mitstr will process each of the specified files , placing a 
massaged version of the input file in a file whose name con- 
sists of the specified prefix and the original name. A typ- 
ical usage of mkstr would be: 



mkstr pistrings xx *.c 

This command would cause all the error messages from 
source files in the current directory to be placed 
file pistrings and processed copies of the source for 
files "- '-- -, — . ^ . , 

XX. 



the C 
in the 
these 



to be placed in files whose names are prefixed with 



To proces 
file mkst 
Each time 
placed i 
a new-lin 
sage so 
character 
sage fil 
input fil 
which can 



s the error messages in the source to the message 
r keys on the string 'errorC" in the input stream. 

it occurs, the C string starting at the ' "' is 
n the message file followed by a null character and 
e character; the null character terminates the mes- 

it can be easily used when retrieved, the new-line 

makes it possible to sensibly cat the error mes- 
e to see its contents. The massaged copy of the 
e then contains an Iseek pointer into the file 

be used to retrieve the message, i.e.: 



char efilname[] = "/usr/lib/pistrings"; 
int efil = -1; 

error(al, a2, a3, a4 ) 

char buf [BUFSIZ]; 

if (efil < 0) { 

efil = open(ef ilname, FATT RDONLY); 
if (efil < 0) { 



oops: 



perror(ef ilname) ; 
exit(l); 
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} 

if (lseek(efil, (long) al, FSEEK_ABSOLUTE ) 
I I read(efil, buf , sizeof buf ) <= 0) 
goto oops; 
printf(buf, a2, a3, a4); 



} 



The optional "-" causes the error messages to be placed at 
the end of the specified message file for recompiling part 
of a large program upon which mkstr has already been run. 

SEE ALSO 

xstr(l), lseek(2) 

RESTRICTIONS 

All the arguments except the name of the file to be pro- 
cessed are unnecessary. 

AUTHORS 

Bill Joy and Charles Haley 
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NAME 

more, page - file perusal filter for crt viewing 

SYNOPSIS 

more [-cdflsu] [-n] [ + linenumber ] [ +/ pattern ] [name ...] 

page more options 

DESCRIPTION 

More is a filter which allows examination of a continuous 

text one screenful at a time on a soft-copy terminal. It 

normally pauses after each screenful, printing — More — at 
the bottom of the screen. If the user then types a carriage 

return, one more line is displayed. If the user hits a 

space, another screenful is displayed. Other possibilities 
are enumerated later. 

The command line options are: 

-n An integer which is the size (in lines) of the window 
which more will use instead of the default. 

-c More will draw each page by beginning at the top of the 
screen and erasing each line just before it draws on 
it. This avoids scrolling the screen, making it easier 
to read while more is writing. This option will be 
ignored if the terminal does not have the ability to 
clear to the end of a line. 

-d More will prompt the user with the message "Hit space 
to continue, Rubout to abort" at the end of each 
screenful. This is useful if more is being used as a 
filter in some setting, such as a class, where many 
users may be unsophisticated. 

-f This causes more to count logical, rather than screen 
lines. That is, long lines are not folded. This 
option is recommended if nroff output is being piped 
through ul, since the latter may generate escape 
sequences. These escape sequences contain characters 
which would ordinarily occupy screen postions, but 
which do not print when they are sent to the terminal 
as part of an escape sequence. Thus more may think 
that lines are longer than they actually are, and fold 
lines erroneously. 

-1 Do not treat '^L (form feed) specially. If this option 
is not given, more will pause after any line that con- 
tains a '^L, as if the end of a screenful had been 
reached. Also, if a file begins with a form feed, the 
screen will be cleared before the file is printed. 
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-s Squeeze multiple blank lines from the output, producing 
only one blank line. Especially helpful when viewing 
nrof f output, this option maximizes the useful informa- 
tion present on the screen. 

-u Normally, more will handle underlining such as produced 
by nrof f in a manner appropriate to the particular ter- 
minal: if the terminal can perform underlining or has 
a stand-out mode, more will output appropriate escape 
sequences to enable underlining or stand-out mode for 
underlined information in the source file. The -u 
option suppresses this processing. 

+ linenumber 

Start up at linenumber . 

+/ pattern 

Start up two lines before the line containing the regu- 
lar expression pattern . 

If the program is invoked as page , then the screen is 
cleared before each screenful is printed (but only if a full 
screenful is being printed) , and k - 1 rather than k - 2 
lines are printed in each screenful, where k is the number 
of lines the terminal can display. 

More looks in the file / etc / termcap to determine terminal 

characteristics, and to determine the default window size. 

On a terminal capable of displaying 24 lines, the default 
window size is 22 lines. 

More looks in the environment variable MORE to pre-set any 
flags desired. For example, if you prefer to view files 
using the -c mode of operation, the csh command setenv MORE 
-c or the sh command sequence MORE = ' -c ' ; export MORE would 
cause all invocations of more , including invocations by 
programs such as man and msgs , to use this mode. Normally, 
the user will place the command sequence which sets up the 
MORE environment variable in the .cshrc or . profile file. 

If more is reading from a file, rather than a pipe, then a 
percentage is displayed along with the — More — prompt. 
This gives the fraction of the file (in characters, not 
lines) that has been read so far. 

Other sequences which may be typed when more pauses, and 
their effects, are as follows (J^ is an optional integer 
argument, defaulting to 1) : 

j^<space> 

display ^ more lines, (or another screenful if no argu- 
ment is given) 



MORE(l) MORE(l) 



■^D display 11 more lines (a 'scroll'). If i is given, 
then the scroll size is set to i. 

d same as '^D (control-D) 

iz same as typing a space except that i, if present, 
becomes the new window size. 

is skip i lines and print a screenful of lines 

j^f skip i screenfuls and print a screenful of lines 

q or Q 

Exit from more . 

= Display the current line number. 

V Start up the editor vi at the current line. 

h Help command; give a description of all the more com- 
mands. 

j./expr 

search for the i^-th occurrence of the regular expres- 
sion expr . If there are less than i^ occurrences of 
ex£r, and the input is a file (rather than a pipe), 
then the position in the file remains unchanged. Oth- 
erwise, a screenful is displayed, starting two lines 
before the place where the expression was found. The 
user's erase and kill characters may be used to edit 
the regular expression. Erasing back past the first 
column cancels the search command. 

in search for the Uth occurrence of the last regular 
expression entered. 

(single quote) Go to the point from which the last 
search started. If no search has been performed in the 
current file, this command goes back to the beqinnina 
of the file. ^ 

! command 

invoke a shell with command . The characters '%' and '!' 
in "command" are replaced with the current file name 
and the previous shell command respectively. If there 
is no current file name, '%' is not expanded. The 
sequences "\%" and "\!" are replaced by "%" and "!" 
respectively. 

i:u skip to the i-th next file given in the command line 
(skips to last file if n doesn't make sense) 



MORE(l) MORE(l) 



j^:p skip to the i-th previous file given in the command 
line. If this command is given in the middle of print- 
ing out a file, then more goes back to the beginning of 
the file. If i doesn't make sense, more skips back to 
the first file. If more is not reading from a file, 
the bell is rung and nothing else happens. 

:f display the current file name and line number. 

:q or :Q 

exit from more (same as q or Q) . 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not neces- 
sary to type a carriage return. Up to the time when the 
command character itself is given, the user may hit the line 
kill character to cancel the numerical argument being 
formed. In addition, the user may hit the erase character 
to redisplay the — More — (xx%) message. 

At any time when output is being sent to the terminal, the 
user can hit the quit key (normally control-\). More will 
stop sending output, and will display the usual --More — 
prompt. The user may then enter one of the above commands 
in the normal manner. Unfortunately, some output is lost 
when this is done, due to the fact that any characters wait- 
ing in the terminal's output queue are flushed when the quit 
signal occurs. 

The terminal is set to noecho mode by this program so that 
the output can be continuous. What you type will thus not 
show on your terminal, except for the / and ! commands. 

If the standard output is not a teletype, then more acts 
just like cat, except that a header is printed before each 
file (if there is more than one). 

A sample usage of more in previewing nrof f output would be 

nroff -ms +2 doc.n I more -s 

AUTHOR 

Eric Shienbrood, minor revisions by John Foderaro and Geof- 
frey Peck 

FILES 

/etc/termcap Terminal data base 
/usr/lib/more.help Help file 
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NAME 

mount, umount - mount and dismount file system 

SYNOPSIS 

/etc/mount [ special name [ -r ] ] 

/etc/umount special 

/etc/mount -a 

/etc/umount -a 

DESCRIPTION 

Mount announces to the system that a removable file system 
IS present on the device special . The file name must exist 
already; it must be a directory Tunless the root of the 
mounted file system is not a directory). It becomes the 
name of the newly mounted root. The optional last argument 
indicates that the file system is to be mounted read-only. 

Umount announces to the system that the removable file sys- 
tem previously mounted on device special is to be removed. 

These commands maintain a table of mounted devices. If 

invoked without an argument, mount prints the table. Only 

the superuser may mount and dismount file systems, any user 
may list the mount table. 

The '-r' option declares that the file system is to be 
mounted read only. Physically write-protected and magnetic 
tape file systems must be mounted read-only or errors will 
occur when access times are updated, whether or not any 
explicit write is attempted. 

The '-a' option causes all file systems listed in the file 
system table (/etc/fstab) to be mounted or dismounted. To 
allow for nested file systems mounts, dismounts are done in 
reverse order, i.e., the last entry in the fstab is 
dismounted first. 

FILES 

/etc/fstab - file system information table 
/etc/mtab - mount table 

SEE ALSO 

mount(2), fstab(5), mtab(5) 

ULTRIX-11 System Management Guide, Sections 4.5.6 and 4.5.7 

RESTRICTIONS 

Mounting file systems full of garbage will crash the system. 
Mounting a root directory on a non-directory makes some 
apparently good pathnames invalid. 
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NAME 

mv - move or rename files and directories 

SYNOPSIS 

mv filel file2 

mv file ... directory 

DESCRIPTION 

Mv moves (changes the name of) filel to f ile2 . 

If f ile2 already exists, it is removed before filel is 
moved. If f ile2 has a mode which forbids writing, mv prints 
the mode (see chmod (2) ) and reads the standard input to 
obtain a line; if the line begins with y, the move takes 
place; if not, mv exits. 

In the second form, one or more files are moved to the 
directory with their original file-names. 

Mv refuses to move a file onto itself. 

SEE ALSO 

cp(l), chmod(2) 

RESTRICTIONS 

If filel and f ile2 lie on different file systems, mv must 
copy the file and delete the original. In this case the 
owner name becomes that of the copying process and any link- 
ing relationship with other files is lost. 

Mv should take -f flag, like rm, to suppress the question if 
the target exists and is not writable. 
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NAME 



ncheck - generate names from i-numbers 



SYNOPSIS 

ncheck [ -i numbers ] [ -a ] [ -s ] filesystem 

DESCRIPTION 

Ncheck with no other arguments generates a pathname vs. i- 
number list of all files on the file system. Names of 
directory files are followed by '/.'. The -i option reduces 
the report to only those files whose i-numbers follow. The 
-a option allows printing of the names '.' and '..', which 
are ordinarily suppressed. suppressed. The -s option 
reduces the report to special files and files with set- 
user-ID mode; it is intended to discover concealed viola- 
tions of security policy. 

A file system must be specified. 

The report is in no useful order, and probably should be 
sorted. 



SEE ALSO 

dcheck(l) , 



icheck(l), sort(l) 



DIAGNOSTICS 

When the filesystem structure is improper, '??' denotes the 
'parent' of a parentless file and a pathname beginning with 
'...' denotes a loop. 
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NAME 

newgrp - log in to a new group 

SYNOPSIS 

newgrp group 

DESCRIPTION 

Newgrp changes the group identification of its caller, 
analogously to login (l) . The same person remains logged in, 
and the current directory is unchanged, but calculations of 
access permissions to files are performed with respect to 
the new group ID. 

A password is demanded if the group has a password and the 
user himself does not. 

When most users log in, they are members of the group named 
'other.' Newgrp is known to the shell, which executes it 
directly without a fork. 

FILES 

/etc/group, /etc/passwd 

SEE ALSO 

login(l), group{5) 
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NAME 

nice, nohup - run a command at low priority 

SYNOPSIS 

nice [ - number ] command [ arguments ] 

nohup command [ arguments ] 

DESCRIPTION 

Nice executes command with low scheduling priority. If the 
y^y^g'^ argument is present, the priority is incremented 
(higher numbers mean lower priorities) by that amount up to 
a limit of 20. The default number is 10. 

The super-user may run commands with priority higher than 
normal by using a negative priority, e.g. ' — 10 



I 



Nohup executes command immune to hangup and terminate sig- 
nals from the controlling terminal. The priority is incre- 
mented by 5. Nohup should be invoked from the shell with 
'Sc' in order to prevent it from responding to interrupts by 
or stealing the input from the next person who logs in on 
the same terminal. 

FILES 

nohup. out standard output and standard error file under 
nohup 

SEE ALSO 

nice(2) 

DIAGNOSTICS 

Nice returns the exit status of the subject command. 
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NAME 

nm - print name list 

SYNOPSIS 

nm [ -gnopru ] [ file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file 
In the argument list. If an argument is an archive, a list- 
ing for each object file in the archive will be produced. 
If no file is given, the symbols in 'a. out' are listed. 

Each symbol name is preceded by its value (blanks if unde- 
fined) and one of the letters U (undefined), A (absolute), T 
(text segment symbol), D (data segment symbol), B (bss seg- 
ment symbol), or C (common symbol). If the symbol is local 
(non-external) the type letter is in lower case. If the 
'a. out' file is an overlay text executable (0430 or 0431), 
all test segment symbols are followed by their overlay text 
segment number. The output is sorted alphabetically. 

Options are: 

-g Print only global (external) symbols. 

-n Sort numerically rather than alphabetically. 

-o Prepend file or archive element name to each output 
line rather than only once. 

-p Don't sort; print in symbol-table order. 

-r Sort in reverse order. 

-u Print only undefined symbols. 

SEE ALSO 

ar(l), ar(5), a.out(5) 
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NAME 

od - octal dump 

SYNOPSIS 

od [ -bcdox ] [ file ] [ [ + ]offset[ . ][ b ] ] 

DESCRIPTION 

Od dumps file in one or more formats as selected by the 

niff i/""^);!;!®"^* .^^ ^^^ first argument is missing, -o is 
default. The meanings of the format argument characters 

b Interpret bytes in octal. 

c Interpret bytes in ASCII. Certain non-graphic characters 
appear as C escapes: null=\0, backspace=\b, formfeed=\f. 
newline=\n, return=\r, tab=\t; others appear as 3-diqit 
octal numbers. ^^yit 

d Interpret words in decimal, 
o Interpret words in octal. 
X Interpret words in hex. 

The file argument specifies which file is to be dumped. if 
no file argument is specified, the standard input is used. 

The offset argument specifies the offset in the file where 
dumping is to commence. This argument is normally inter- 
preted as octal bytes. If '.' is appended, the offset is 
interpreted m decimal. If 'b' is appended, the offset is 
iJ^-fPr^?? m blocks of 512 bytes. If the file argument is 
omitted, the offset argument must be preceded '+'. 

Dumping continues until end-of-file. 

SEE ALSO 

adb(l) 
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NAME 



osload - load optional software on Micro/PDP-11 



SYNOPSIS 

osload 



DESCRIPTION 

The osload command is used to load optional software from 
RX50 diskettes onto the RD51/RD52 Winchester disk of the 
Micro/PDP-11. Refer to Section 3.8 of the ULTRIX-11 Instal- 
lation Guide for a description of the osload command. 
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NAME 

passwd - change login password 

SYNOPSIS 

passwd [ name ] 

DESCRIPTION 

This command changes (or installs) a password associated 
with the user name (your own name by default). 

The program prompts for the old password and then for the 
new one. The caller must supply both. The new password 
must be typed twice, to forestall mistakes. 

New passwords must be at least four characters long if they 
use a sufficiently rich alphabet and at least six characters 
long If monocase. These rules are relaxed if you are 
insistent enough. ^ 

Only the owner of the name or the super-user may change a 
password; the owner must prove he knows the old password. 

FILES 

/etc/passwd 

SEE ALSO 

login(l), passwd(5), crypt (3) 

Robert Morris and Ken Thompson, Passw ord Security: A Case 
History — ^ - - 
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NAME 



paste 


- merge same 


lines 


of one file 


SYNOPSIS 




paste 


filel file2 


paste 


-dlist filel 


paste 


-s [-dlist] 



lines of several files 



or 



subsequent 



file2 ... 

filel file2 



DESCRIPTION 

In the first two forms, paste concatenates corresponding 
lines of the given input files filel , f ile2 , etc. It treats 
each file as a column or columns of a table and pastes them 
together horizontally (parallel merging). If you will, it 
is the counterpart of cat(l) which concatenates vertically, 
i.e., one file after the other. In the last form above, 
paste subsumes the function of an older command with the 
same name by combining subsequent lines of the input file 
(serial merging). In all cases, lines are glued together 
with the tab character, or with characters from an option- 
ally specified list . Output is to the standard output, so 
it can be used as the start of a pipe, or as a filter, if - 
is used in place of a file name. 

The meanings of the options are: 

-d Without this option, the new-line characters of each 
but the last file (or last line in case of the -s 
option) are replaced by a tab character. This option 
allows replacing the tab character by one or more 
alternate characters (see below). 



list 



-s 



One or more characters immediately following -d replace 
the default tab as the line concatenation character. 
The list is used circularly, i. e. when exhausted, it 
is reused. In parallel merging (i. e. no -s option), 
the lines from the last file are always terminated with 
a new-line character, not from the list . The list may 
contain the special escape sequences: \n (new-line), \t 
(tab), \\ (backslash), and \0 (empty string, not a null 
character). Quoting may be necessary, if characters 
have special meaning to the shell (e.g. to get one 
backslash, use "" -d"\\\\" ). 



Merge 
file. 



subsequent 
Use tab 



lines rather than one from each input 

for concatenation, unless a list is 

specified with -d option. Regardless of the list , the 
very last character of the file is forced to be a new- 
line. 



May be used in place of any file name, to read a line 
from the standard input. (There is no prompting). 
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EXAMPLES 

Is I paste -d" " - 

list directory in one column 

Is I paste - - - - 

list directory in four columns 

paste -s -d"\t\n" file 

combine pairs of lines into lines 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr -t -m... works similarly, but creates extra 

blanks, tabs and new-lines for a nice page layout. 

DIAGNOSTICS 

line too long 

Output lines are restricted to 511 characters. 

too many files 

Except for -s option, no more than 12 input files 
may be specified. 
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NAME 

plot - graphics filters 

SYNOPSIS 

plot [ -Tterminal [ raster ] ] 

DESCRIPTION 

These conunands read plotting instructions (see plot (5) ) from 
the standard input, and in general produce plotting instruc- 
tions suitable- for a particular terminal on the standard 
output . 

If no terminal type is specified, the environment parameter 
$TERM (see environ (5)) is used. Known terminals are: 

4014 Tektronix 4014 storage scope. 

450 DASI Hyterm 450 terminal (Diablo mechanism) . 

300 DASI 300 or GSI terminal (Diablo mechanism). 

300S DASI 300S terminal (Diablo mechanism). 

ver Versatec D1200A printer-plotter. This version of plot 
places a scan-converted image in Vusr/tmp/raster ' and 
sends the result directly to the plotter device rather 
than to the standard output. The optional argument 
causes a previously scan-converted file raster to be 
sent to the plotter. 

FILES 

/usr/bin/tek 

/usr/bin/t450 

/usr/bin/t300 

/usr/bin/t300s 

/usr/bin/vplot 

/usr/tmp/r aster 

SEE ALSO 

plot(3), plot(5) 

RESTRICTIONS 

There is no lockout protection for /usr/tmp/raster. 
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NAME 

pr - print file 

SYNOPSIS 

pr [ option ] ... [ file ] ... 

DESCRIPTION 

Pr produces a printed listing of one or more files . The out- 
put is separated into pages headed by a date, the name of 
the file or a specified header, and the page number. if 
there are no file arguments, £r prints its standard input. 

Options apply to all following files but may be reset 
between files: 

-n Produce n-column output. 

+n Begin printing with page n. 

-h Take the next argument as a page header. 

-wn For purposes of multi-column output, take the width of 
the page to be n characters instead of the default 72. 

-In Take the length of the page to be n lines instead of 
the default 66. 

-t Do not print the 5-line header or the 5-line trailer 
normally supplied for each page. 

-sc Separate columns by the single character c instead of 
by the appropriate amount of white space. A missing c 
is taken to be a tab. ~ 

-m Print all files simultaneously, each in one column, 

Inter-terminal messages via write (l) are forbidden during a 
HI- 
FILES 

/dev/tty? to suspend messages. 

SEE ALSO 

cat(l) 

DIAGNOSTICS 

There are no diagnostics when £r is printing on a terminal. 
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NAME 

prep - prepare text for statistical processing 

SYNOPSIS 

prep C -dio ] file . . . 

DESCRIPTION 

Prep reads each file in sequence and writes it on the stan- 
dard output, one 'word' to a line. A word is a string of 
alphabetic characters and imbedded apostrophes, delimited by 
space or punctuation. Hyphenated words are broken apart; 
hyphens at the end of lines are removed and the hyphenated 
parts are joined. Strings of digits are discarded. 

The following option letters may appear in any order: 

-d Print the word number (in the input stream) with each 
word. 

-i Take the next file as an 'ignore' file. These words 
will not appear in the output. (They will be counted, 
for purposes of the -d count.) 

-o Take the next file as an 'only' file. Only these words 
will appear in the output. (All other words will also 
be counted for the -d count.) 

-p Include punctuation marks (single nonalphanumeric char- 
acters) as separate output lines. The punctuation 
marks are not counted for the -d count. 

Ignore and only files contain words, one per line. 

SEE ALSO 

deroff(l) 



PRINTENV(l) PRINTENV(l) 



NAME 

printenv - print out the environment 

SYNOPSIS 

printenv [ name ] 

DESCRIPTION 

Printenv prints out the values of the variables in the 
environment. If a name is specified, only its value is 
printed. 

If a name is specified and it is not defined in the environ- 
ment, printenv returns exit status 1, else it returns status 
u • 

SEE ALSO 

csh(l), sh(l), environ(5) 
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NAME 



prof - display profile data 



SYNOPSIS 

prof [ -V ] [ -a ] [ -1 ] [ -low [ - high ] ] [ file ] 

DESCRIPTION 

Prof interprets the file mon . out produced by the monitor 
subroutine. Under default modes, the symbol table in the 
named object file (a. out default) is read and correlated 
with the mon . out profile file. For each external symbol, 
percentage of time spent executing between that symbol 
the next is printed (in decreasing order), together with 
nximber of times that routine was called and the number 



the 
and 
the 
of milliseconds 



per call. 



If the -a option is used, all symbols are reported rather 
than just external symbols. If the -1 option is used, the 
output is listed by symbol value rather than decreasing per- 
centage. 

If the -V option is used, all printing is suppressed and a 
graphic version of the profile is produced on the standard 
output for display by the plot (l) filters. The numbers low 
and high , by default and 100, cause a selected percentage 
of the profile to be plotted with accordingly higher resolu- 
tion. 



In order for the number of calls to a routine to be tallied, 
the -p option of cc must have been given when the file con- 
taining the routine was compiled. This option also arranges 
for the mon . out file to be produced automatically. 



FILES 



mon . out 
a. out 



for profile 
for namelist 



SEE ALSO 

monitorO), profil(2), cc(l), plot(l) 

RESTRICTIONS 

Beware of quantization errors. 
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NAME 

prs - print an SCCS file 

SYNOPSIS 

prs [-dCdataspec]] [-r[SID]] [-e] [-1] [-a] files 

DESCRIPTION 

Prs prints, on the standard output, parts or all of an SCCS 
file (see sccsfile (5 )) in a user supplied format. If a 
directory is named, prs behaves as though each file in the 
directory were specified as a named file, except that non- 
SCCS files (last component of the path name does not begin 
with s.), and unreadable files are silently ignored. If a 
name of - is given, the standard input is read; each line of 
the standard input is taken to be the name of an SCCS file 
or directory to be processed; non-SCCS files and unreadable 
files are silently ignored. 

Arguments to prs , which may appear in any order, consist of 
keyletter arguments, and file names. 

All the described keyletter arguments apply independently to 
each named file: 

-dC dataspec ] Used to specify the output data specifi- 
cation. The dataspec is a string con- 
sisting of SCCS file data keywords (see 
DATA KEYWORDS ) interspersed with 

optional user supplied text. 

-r[ SID ] Used to specify the SCCS IDentification 

(SID) string of a delta for which infor- 
mation is desired. If no SID is speci- 
fied, the SID of the most recently 
created delta is assumed. 

-e Requests information for all deltas 

created earlier than and including the 
delta designated via the -r keyletter. 

-1 Requests information for all deltas 

created later than and including the 
delta designated via the -r keyletter. 

-a Requests printing of information for 

both removed, i.e., delta type = ^, (see 
rmdel (1 )) and existing, i.e., delta type 
= D, deltas. If the -a keyletter is not 
specified, information for existing del- 
tas only is provided. 
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DATA KEYWORDS 

Data keywords specify which parts of an SCCS 
retrieved and output. All parts of an 
sccsfi le(5)) have an associated data keyword 
limit 



on 

dataspec . 



the number of times a data keyword 



file are to be 

SCCS file (see 

There is no 

may appear in a 



The information printed by prs consists of: (1) the user 
supplied text; and (2) appropriate values (extracted from 
the SCCS file) substituted for the recognized data key- 
words in the order of appearance in the dataspec . The for- 
mat of a data keyword value is either Simple (S), in which 
keyword substitution is direct, or Multi - line (M) , in which 
keyword substitution is followed by a carriage return. 



User supplied text is any text other than 
keywords. A tab is specified by 

return/new-line is specified by \n. 



recognized data 
\t and carriage 



Keyword 
:Dt : 
:DL: 
: Li : 
:Ld: 
: Lu : 

:DT: 
I: 
R: 
;L: 
:B: 
S: 
D: 
:Dy : 
: Dm : 
:Dd: 
:T: 
:Th: 
:Tm: 
:Ts: 
:P: 

:DS: 
:DP: 

:DI: 

:Dn : 
:Dx : 
:Dg: 
:MR: 



TABLE 1. SCCS Files Data Keywords 



Data Item 



information 
line statistics 
inserted by Delta 
deleted by Delta 
unchanged by 



(SID) 



Delta 

Delta 

Lines 

Lines 

Lines 

Delta 

Delta type 

SCCS ID string 

Release number 

Level number 

Branch number 

Sequence number 

Date Delta created 

Year Delta created 

Month Delta created 

Day Delta created 

Time Delta created 

Hour Delta created 

Minutes Delta created 

Seconds Delta created 

Programmer who created 

Delta 

Delta sequence number 

Predecessor Delta seq- 

no . 

of deltas 
excl., ignored 
included (seq #) 
excluded (seq #) 
ignored (seq #) 



Seq-no . 
incl . , 
Deltas 
Deltas 
Deltas 



File Sec 


tion 




Value 


Format 


Delta Table 


Se 


'e below* 


S 


ti 




:Li- 


/ : Ld : / : Lu : 


S 


It 






nnnnn 


S 


It 






nnnnn 


S 


ti 






nnnnn 


s 


ti 






D or R 


s 


ti 




:R: 


• T • • R • ■ <> ■ 


s 


It 






nnnn 


s 


It 






nnnn 


s 


It 






nnnn 


s 


It 






nnnn 


s 


It 




:Dy 


: / : Dm : / : Dd : 


s 


It 






nn 


s 


tt 






nn 


s 


It 






nn 


s 


It 




:Th 


: : : Tm : : : Ts : 


s 


II 






nn 


s 


It 






nn 


s 


11 






nn 


s 


11 






logname 


s 


It 






nnnn 


s 


It 






nnnn 


s 



: Dn : / : Dx : / : Dg 



MR numbers for delta 



It 


: DS : : DS : . . . 


s 


tt 


: DS : : DS : . . . 


s 


It 


• jJo • • Uo • • • • 


s 


It 


text 


M 
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:C 
:UN 
:FL 

:Y 
:MF 
:MP 
:KF 

:BF 

:J 

:LK 

:Q 

:M 

:FB 

:CB 

:Ds 

:ND 

:FD 

:BD 

:GB 

:W 

:A: 

:Z: 

:F: 
:PN: 

' :Dt 



Comments for delta 

User names 

Flag list 

Module type flag 

MR validation flag 

MR validation pgm name 

Keyword error/warning 

flag 

Branch flag 

Joint edit flag 

Locked releases 

User defined keyword 

Module name 

Floor boundary 

Ceiling boundary 

Default SID 

Null delta flag 

File descriptive text 

Body 

Gotten body 

A form of what(l) 

string 

A form of what(l) 

string 

what(l) string delim- 

iter 

sees file name 

sees file path name 



ser Names 

Flags 
It 


text 
text 
text 
text 


M 
M 
M 
S 


It 
II 


yes or no 
text 


S 
S 


II 


yes or no 


S 


11 
11 
II 
II 
It 
II 
It 
11 


yes or no 
yes or no 

•R* 

• il • • • • 

text 
text 

:R: 

:R: 

:I: 


S 

S 

s 
s 
s 
s 
s 
s 


ti 

Comments 

Body 
II 

N/A 


yes or no 
text 
text 
text 
:Z::M:\t:I: 


s 

M 
M 
M 

s 


N/A : 


Z::Y: :M: :I::Z: 


S 


N/A 


§(#) 


S 


N/A 
N/A 


text 
text 


S 
S 



DT: 



:D: :T: :P: 



DS; 



DP: 



EXAMPLES 



prs -d"Users and/or user IDs for :F: are:\n:UN:" s.file 
may produce on the standard output: 

Users and/or user IDs for s.file are: 

xyz 

131 

abc 

prs -d"Newest delta for pgm :M:: :I: Created :D: Bv 
:P:" -r s.file 

may produce on the standard output: 

Newest delta for pgm main .c : 3.7 Created 77/12/1 By cas 
As a special case : 

prs s.file 
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may produce on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 

MRs: 

bl78-123M5 

bl79-54321 

COMMENTS: 

this is the comment line for s.file initial delta 

for each delta table entry of the 'D' type. The only 
keyletter argument allowed to be used with the special case 
is the -a keyletter. 

FILES 

/tmp/pr????? 

SEE ALSO 

admind), delta(l), get(1), help(l), sccsfile(5). 

Source Code Control System User ' s Guide by L. E. Bonanni and 

C. A. Sal em i. 

DIAGNOSTICS 

Use help(l) for explanations. 
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NAME 

ps - process status 

SYNOPSIS 

ps [ alxvt# ] [ namelist ] [ corefile ] 

DESCRIPTION 

Ps prints certain indicia about active processes. The a 
option asks for information about all processes with termi- 
nals (ordinarily only one's own processes are displayed); x 
asks even about processes with no terminal; 1 asks for a 
long listing. The short listing contains the process ID, 
tty letter, the cumulative execution time of the process and 
an approximation to the command line. If v is given and 1 
is not present, the sums of the child process's system and 
user times are printed following the cxomulative execution 
time. The t option limits printouts to those processes 
associated with tty #. Specifying ? as the tty number to 
the t option will limit printouts to those processes not 
associated with a tty. 

The long listing is columnar and contains 

F Flags associated with the process. 001: in core; 002: 
system process; 004: locked in core (e.g. for physical 
I/O); 010: being swapped; 020: being traced by another 
process; 040: another tracing flag; 100: user settable 
lock in core; 200: detached inheritaed by init; 400: 
using new signal mechanism. 

S The state of the process. 0: nonexistent; S: sleeping; 
W: waiting; R: running; I: intermediate; Z: terminated; 
T: stopped. 

UID The user ID of the process owner. 

PID The process ID of the process; as in certain cults it 
is possible to kill a process if you know its true 
name. 

PPID The process ID of the parent process. 

CPU Processor utilization for scheduling. 

PRI The priority of the process; high numbers mean low 
priority. 

NICE Used in priority computation. 

ADDR If the process is resident, the memory address in octal 
expressed as 64 byte clicks. ADDR is left shifted six 
places to obtain the physical memory address. If the 
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process is swapped out, the disk address in decimal, 
that is, the block n\amber relative to the start of the 
swap area, where the image of the process resides. 

SZ The size in 512 byte blocks of the core image of the 
process. 

WCHAN 

The event for which the process is waiting or sleeping; 
if blank, the process is running. 

TTY The controlling tty for the process. 

TIME The cumulative execution time for the process. 

The command and its arguments. 

A process that has exited and has a parent, but has not yet 
been waited for by the parent is marked <defunct>. Ps makes 
an educated guess as to the file name and arguments given 
when the process was created by examining core memory or the 
swap area. The method is inherently somewhat unreliable and 
in any event a process is entitled to destroy this informa- 
tion, so the names cannot be counted on too much. 

The optional third argument specifies a corefile to be used 
in place of /dev/mem . This is used for postmortem system 
debugging. If a second argximent is given, it is taken to be 
the file containing the system's namelist. 

FILES 

/unix default system namelist 

/dev/mem default core memory file 

/usr/crash/core alternate core file for crash dump analysis 

/dev searched to find swap device and tty names 

SEE ALSO 

kilKl) 

ULTRIX-11 System Management Guide, Section 9.5.6 

RESTRICTIONS 

Things can change while 25 is running; the picture it gives 

is only a close approximation to reality. 

Some data printed for defunct processes is irrelevant 
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NAME 



pstat - print system facts 



SYNOPSIS 

pstat [ -aixptuf ] [ suboptions ] [ corefile ] [ namelist ] 

DESCRIPTION 

||tat interprets the contents of certain system tables. if 
5°'^^^/^^ IS given, the tables are sought there, otherwise in 
7div7|ei. The required namelist is taken from /unix infesS 
the optional namelist argument is given. If thi-Him4list is 
specified then the corefile must also be specified. Optioil 



-a 



-1 



Under -p, describe all process slots rather than 
active ones. 

Print the inode table with the these headings: 



just 



LOC The core location of this table entry 
FLAGS Miscellaneous state variables encoded'thus: 



L 
U 
A 
M 
W 
T 
C 



locked 

update time filsys (5)) must be corrected 

access time must be corrected 

file system is mounted here 

wanted by another process (L flag is on) 

contains a text file 

changed time must be corrected 

CNT Number of open file table entries for 

DEV Major and minor device number of file 
this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod (2) . 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV 

Number of bytes in an ordinary 
minor device of special file. 



this inode. 
system in which 



file, or major and 



-X 



Print the text table with these headings: 



LOC The core location of this table entry 
FLAGS Miscellaneous state variables encoded'thus- 
T ptrace (2) in effect 

text not yet written on swap device 

loading in progress 

locked 

wanted (L flag is on) 



W 
L 
K 
w 



DADDR Disk address in swap, measured in (decimal) 
of 512 bytes. 



multiples 
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CADDR Core address, measured in (octal) multiples of 64 
bytes. 

SIZE Size of text segment, measured in (decimal) multiples 
of 64 bytes. 

IPTR Core location of corresponding inode. 

CNT Nxomber of processes using this text segment. 

CCNT Number of processes in core using this text segment. 

-p Print process table for active processes with these 
headings: 



LOC The core location of this table entry. 
S Run state encoded thus: 

no process 

1 waiting for some event 

3 runnable 

4 being created 

5 being terminated 

6 stopped under trace 

F Miscellaneous state variables, or-ed together: 

01 loaded 

02 the scheduler process 
04 locked 

010 swapped out 

020 traced 

040 used in tracing 

0100 locked in by lock (2) 

0200 detached inherited by 

0400 



PR I 
SIGNAL 

UID 

TIM 

CPU 

NI 

PGRP 



detached inherited by init 
using new signal mechanism. 
Scheduling priority, see nice(2) 



in bits 0-15) 



Signals received (signals 1-16 coded 
Real user ID. 

Time resident in seconds; times over 127 coded as 127. 
Weighted integral of CPU time, for scheduler. 
Nice level, see nice (2) . 

Process number of root of process group (the opener of 
the controlling terminal). 
The process ID nxjmber. 
The process ID of parent process. 

If in core, the physical address of the 'u-area' of 
the process measured in (octal) multiples of 64 bytes. 
If swapped out, the position in the swap area measured 
in (decimal) multiples of 512 bytes. 

If in core, size of process image in (decimal) multi- 
ples of 64 bytes. If swapped out, size of the process 
image in (decimal) 512 byte blocks. 
WCHAN Wait channel number of a waiting process. 



PID 

PPID 

ADDR 



SIZE 
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Link pointer in list of runnable processes. 
TEXTP If text is pure, pointer to location of text table 
entry. 

CLKT Countdown for alarm (2) measured in seconds. 

"^ l^^^^ ^^^^^ ^°^ terminals (DH, KL, DL, DZ, and DZV 
handled) with these headings: 

lUW Number of characters in raw input queue. 

CAN Number of characters in canonical ized input queue. 

OUT Number of characters in output queue. 

MODE See tt^(4). 

ADDR Physical device address. 

DEL Number of delimiters (newlines) in canonicalized input 
queue. ^ 

COL Calculated column position of terminal. 
STATE Miscellaneous state variables encoded thus: 

T timeout (carriage return or newline 'delay oro- 
cessmg) 

W waiting for open to complete 

open 

C carrier is on 

B busy doing output 

A process is awaiting output 

X open for exclusive use 

S output is stopped by stop character 

M blocked output (tandem mode, see tty (4) ) 

H hangup on close 

Soo™^^°^®^^ ^"^^^P ^°^ ^^^^^ ^^^s is controlling terminal. 

ERRCNT 

Number of errors on the line, since the system was 
last booted. 
LASTEC 

Last error character, as received on the line. Char- 
acter in lo byte, error bits in hi byte. 
Bit 15 - Combined error bit 
Bit 14 - Overrun error 
Bit 13 - Framing error 
Bit 12 - Parity error 

For DL and KL all three types of errors are counted. 
For DH, DHU/DHV, DZ/DZV, and DZQ, overruns are 
counted, framing errors are not counted, and parity 
errors are counted only if parity is enabled. 



-u 



print information about a user process; the next argu- 
ment IS Its address as given by £s(l). The process 
must be in mam memory, or the file used can be a core 
image and the address 0. 

-f Print the open file table with these headings: 
LOG The core location of this table entry. 
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FLG 



CNT 
I NO 
OFFS 



Miscellaneous state variables encoded thus: 

R open for reading 

W open for writing 

P pipe 

Number of processes that know this open file. 

The location of the inode table entry for this file. 

The file offset, see lseek (2) . 



FILES 



/unix default namelist 
/dev/mem default source of tables 



SEE ALSO 

ps(l), stat{2), filsys{5) 
ULTRIX-11 System Management Guide, 
K. Thompson, UNIX Implementation 



Section 9.5.6 
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NAME 

ptx - permuted index 



PTX ( 1 ) 



SYNOPSIS 

ptx [ option ] ... [ input [ output ] ] 

DESCRIPTION 

Ptx generates a permuted index to file inpu t on file output 
(standard input and output default). It has three p hases; 
the first does the permutation, generating one line for each 
keyword in an input line. The keyword is rotated to the 
front. The permuted file is then sorted. Finally the 
sorted lines are rotated so the keyword comes at the middle 
of the page. Ptx produces output in the form: 

.XX "tail" "before keyword" "keyword and after" "head" 

where .xx may be an nroff or troff (l) macro for user-defined 
formatting. The before keyword and keyword and after fields 
incorporate as much of the line as will fit around the key- 
word when It IS printed at the middle of the page. Tail and 
head, at least one of which is an empty string '^ — are 
wrapped-around pieces small enough to fit in the unused 
space at the opposite end of the line. When original text 
must be discarded, '/' marks the spot. 

The following options can be applied: 

-f Fold upper and lower case letters for sorting. 

Prepare the output for the phototypesetter; the default 
line length is 100 characters. 

-w n Use the next argument, n, as the width of the output 
line. The default line length is 72 characters. 

-g n Use the next argument, n, as the number of characters 
to allow for each gap among the four parts of the line 
as finally printed. The default gap is 3 characters. 

-o only 

Use as keywords only the words given in the only file. 

-i ignore 

Do not use as keywords any words given in the ignore 

^,^^^%.-^V. ^^^ ~i ^"^ ~9. options are missing, use 
/usr/lib/eign as the ignore file. 

-b break 

Use the characters in the break file to separate words. 
In any case, tab, newline, and space characters are 
always used as break characters. 



-t 
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-r Take any leading nonblank characters of each input line 
to be a reference identifier (as to a page or chapter) 
separate from the text of the line. Attach that iden- 
tifier as a 5th field on each output line. 

The index for this manual was generated using ptx . 

FILES 

/bin/sort 
/usr/lib/eign 

RESTRICTIONS 

Line length counts do not account for overstriking or pro- 
portional spacing. 
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NAME 

pwd - working directory name 

SYNOPSIS 
pwd 

DESCRIPTION 

Pwd prints the pathname of the working (current) directory. 

SEE ALSO 
cd(l) 
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NAME 

quot - sununarize file system ownership 

SYNOPSIS 

quot [ option ] ... [ filesystem ] 

DESCRIPTION 

Quot prints the number of blocks in the named filesystem 
currently owned by each user. If no filesystem is named, a 
default name is assumed. The default name is obtained from 
the file system information table (/etc/fstab) by searching 
for the file system associated with the /usr directory. The 
following options are available: 

-n Cause the pipeline ncheck filesystem I sort +0n I quot 
-n filesystem to produce a list of all files and their 
owners. 

-c Print three columns giving file size in blocks, number 
of files of that size, and cumulative total of blocks 
in that size or smaller file. 

-f Print count of number of files as well as space owned 
by each user. 

FILES 

/dev/r??? - filesystem 

/etc/fstab - default file system name 

/etc/passwd - to get user names 

SEE ALSO 

Isd), du(l) 

DIAGNOSTICS 

If no filesystem is given and no filesystem is mounted on 
the / usr directory, an error message is printed. 

RESTRICTIONS 

Holes in files are counted as if they actually occupied 
space. 
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NAME 



ranlib - convert archives to random libraries 



SYNOPSIS 

ranlib archive . . . 



DESCRIPTION 

Ranlib converts each archive 

rapidly by the loader. 



to a form which can be loaded 
more rapidly by the loader, by adding a table of contents 

named .SYMDEF to the beginning of the archive. It uses 

ard) to reconstruct the archive, so that sufficient tem- 
porary file space must be available in the file system con- 
taining the current directory. 

SEE ALSO 

ld(l), ar(l) 

RESTRICTIONS 

Because generation of a library by ar and randomization by 
ranlib are separate, phase errors are possible. The loader 
Id warns when the modification date of a library is more 
recent than the creation of its dictionary; but this means 
you get the warning even if you only copy the library. 
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NAME 

rasize - report on MSCP disk partition sizes 

SYNOPSIS 

rasize 

DESCRIPTION ^. , ^, 

The RA disk driver supports a variety of MSCP disks. The 
partition sizes for MSCP disks are not known in advance, 
because this information is read from the disk when the 
driver brings it on-line. 

The rasize command reports the following information about 
MSCP disks: 

1. The controller type (UDA50, RQDXl, KLESI, or RUXl) and 
micro-code revision of each MSCP disk controller on the 
system. 

2. The status of each MSCP disk unit, NED for a non- 
existent drive or the disk type (RC25, RA60, RA80, 
RA81, RX50, RD51 or RD52) if the unit exists. A disk 
is non-existent until it becomes available to the 
driver, this occurs on the first access of the disk 
unit. 

3. Which of the eight possible disk partitions may be 
used, when creating file systems. 

4. The absolute maximum sized file system that may be 
created on each available disk partition. This size 
number should be supplied to the /etc/mkfs command when 
making file systems on MSCP disk partitions. 

FILES 

/unix - system namelist 
/dev/mem - system tables 

SEE ALSO 

ULTRIX-11 System Management Guide, Sections 1.3 and 4.6.3 

DIAGNOSTICS 

May cause a "drive offline" message on the console terminal 
if the RX50 drives are not online. 
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NAME 

ratfor - rational Fortran dialect 

SYNOPSIS 

ratfor [ option ... ] [ filename ... ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary 
irrational Fortran. Ratfor provides control flow constructs 
essentially identical to those in C: 

statement grouping: 

{ statement; statement; statement } 

dec is ion-mak i ng : 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

• • • 

[ default: ] statement 

loops : 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break [n] 

next [n] 

and some syntactic sugar to make programs easier to read and write; 

free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment 

translation of relationals: 

>, >=, etc., become .GT. , .GE., etc. 

return (expression) 

returns expression to caller from function 

define: 

define name replacement 

include: 

include filename 

The option -h causes quoted strings to be turned into 27H 
constructs. -c copies comments to the output, and attempts 
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to format it neatly. Normally, continuation lines are 
marked with a & in column 1; the option -6x makes the con- 
tinuation character x and places it in column 6. 

Rat for is best used with f77 (l) » 

SEE ALSO 

f77(l) , ,^j. 

B. W. Kernighan and P. J. Plauger, Software Tools , Addison- 

Wesley, 1976. 
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NAME 



refer, lookbib - find and insert 
documents 



literature references 



in 



SYNOPSIS 

refer [ option ] ... 

lookbib [ file ] ... 



DESCRIPTION 
Lookbib 



accepts keywords from the standard input 



and 



searches a bibliographic data base for references that con- 
tain those keywords anywhere in title, author, journal name, 
etc. Matching references are printed on the standard out- 
put. Blank lines are taken as delimiters between queries. 

Refer is a preprocessor for nroff or troff (l) that finds and 
formats references. The input flTii (standard input 
default) are copied to the standard output, except for lines 
between .1 and .] command lines, which are assumed to con- 
tain keywords as for lookbib , and are replaced by informa- 
tion from the bibliographic data base. The user may avoid 
the search, override fields from it, or add new fields. The 
reference data, from whatever source, are assigned to a set 
°! V^^l strings. Macro packages such as ms(7) print the 
finished reference text from these strTHgs. A flag is 
placed in the text at the point of reference; by default the 
references are indicated by numbers. 

The following options are available: 

-ar Reverse the first r author names (Jones, J. A. instead 
of J. A. Jones). If r is omitted all author names are 
reversed. 

-b Bare mode: do not put any flags in text (neither 
numbers nor labels). 

-c string 

Capitalize (with CAPS SMALL CAPS) the fields whose 
key-letters are in string . 



-e 



Instead of leaving the references where encountered 
accumulate them until a sequence of the form ' 

$LIST$ 

.] 
IS encountered, and then write out all references col- 
lected so far. Collapse references to the same 
source. 



-kx 



:x Instead of numbering references, use labels as 
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specified in a reference data line beginning %x; by 
default X is L. 

-lm,n Instead of numbering references, use labels made from 
the senior author's last name and the year of publica- 
tion. Only the first m letters of the last name and 
the last n digits of the date are used. If either m 
or ,n is omitted the entire name or date respectively 
is used. 

-p Take the next argument as a file of references to be 
searched. The default file is searched last. 

-n Do not search the default file. 

-s keys 

Sort references by fields whose key-letters are in the 
keys string; permute reference nvimbers in text accord- 
ingly. Implies -e. The key-letters in keys may be 
followed by a number to indicate how many such fields 
are used, with + taken as a very large number. The 
default is AD which sorts on the senior author and 
then date; to sort, for example, on all authors and 
then title use -sA+T. 

To use your own references, put them in the format described 
in pubindex (l) They can be searched more rapidly by running 
pubindex (l) on them before using refer ; failure to index 
results in a linear search. 

When refer is used with eqn , neqn or tbl, refer should be 
first, to minimize the volume of data passed through pipes. 

FILES 

/ usr / dict / papers directory of default publication lists and 

indexes 

/ usr / lib/refer directory of programs 



RENICE(l) RENICE(l) 



NAME 

renice - oppress running processes 

SYNOPSIS 

renice newnice pidl [ pid2 ... pidn ] 

DESCRIPTION 

Re"fce will assign pidl , ..., pidn a 'niceness' of newnice. 
Positive niceness means a lower scheduling priority"! Nega- 
tive niceness means a high priority. The super-user may 
renice any process to any value. Other users may renice 
their own processes to any value greater than the current 
value. 

SEE ALSO 

nice(l), nice{2), renice(2) 
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NAME 

restor - incremental file system restore 

SYNOPSIS 

restor key [ argument ... J 

DESCRIPTION 

Restor is used to read magtapes dumped with the dump, com- 
mand. The ke^ specifies what is to be done. Ke^ is one of 
the characters rRxtm optionally combined with f. 

f Use the first argument as the name of the tape instead 
of the default. 



or R 



The tape is read and loaded into the file system speci- 
fied in argument. This should not be done lightly (see 
below). If the key is R restor asks which tape of a 
multi volume set to start on. This allows restor to be 
interrupted and then restarted (an icheck -s must be 
done before restart). 

Each file on the tape named by an argument is 
extracted. The file name has all 'mount' prefixes 
removed; for example, /usr/bin/lpr is named /bin/lpr on 
the tape. The file extracted is placed in a file with 
a numeric name supplied by restor (actually the mode 
number). In order to keep the amount of tape read to a 
minimum, the following procedure is recommended: 

Mount volume 1 of the set of dump tapes. 

Type the restor command. 

Restor will announce whether or not it found the files, 
'^We — the number it will name the file, and rewind the 
tape. 

It then asks you to 'mount the desired tape volume'. 
Type the number of the volume you choose. On a mul- 
tivolume dump the recommended procedure is to mount the 
last through the first volume in that order. Restor 
checks to see if any of the files requested are on the 
mounted tape (or a later tape, thus the reverse order) 
and doesn't read through the tape if no files are. If 
you are working with a single volume dump or the number 
of files being restored is large, respond to the query 
with '1' and restor will read the tapes in sequential 
order. 

If you have a hierarchy to restore you can use dump- 
dir(l) to produce the list of names and a shell script 
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to move the resulting files to their homes. 

t Print the date the tape was written and the date the 
filesystem was dumped from. 

"^ of'''"maat?;;i^' ^??t°^ ^ f^^ RX50 floppy diskettes instead 

nnf^on^ ?P '1 ^ °P^^°" "^^^t accompany the 'm' 
option, for example: jr '- "= 

restor rmf /dev/rrx2 /dev/rrdO 

To allow an interrupted restor to be restarted, restor 
asks for the starting volume number. Before an ifSfr 
rupted restor may be restarted, an icheck -s must £e 
done on the file system. - °® 

The r option should only be used to restore a comolete dumn 
tape onto a clear file system or to restore an incremental 
dump tape onto this. Thus incremental 

/etc/mkfs /dev/rhp03 40600 
restor r /dev/rhp03 

is a typical sequence to restore a complete dump. Another 
res|^ can be done to get an incremental du^p i A on ?op of 

sili^f'f J?TI^^Lem^ ^"' ' ^^^ ^^ ^-^ ^° ^^-^- the 

FILES 

/dev/rhtO - default tape unit 
rst* 

SEE ALSO 

dump(l), mkfs(l), dumpdir(l) 

DIAGNOSTICS 

If the dump extends over more than one tape, it may ask vou 

RESTRICTIONS 

There is redundant information on the tape that could b^ 
Sl'doeSn^rSsfi^!^^ ^^^"^^^ P^^^^^'^- Unfortunate?^:'re^! 
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NAME 

rev - reverse lines of a file 

SYNOPSIS 

rev [ file ] ... 

DESCRIPTION 

Rev copies the named files to the standard output, reversing 
the order of characters in every line. If no file is speci- 
fied, the standard input is copied. 
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NAME 



rm, rmdir - remove (unlink) files 



SYNOPSIS 

rm [ -fri ] file ... 

rmdir dir ... 

DESCRIPTION 

Rm removes the entries for one or more files from a direc- 
tory. If an entry was the last link to the file, the file 
is destroyed. Removal of a file requires write permission 
in its directory, but neither read nor write permission on 
the file itself. 



SEE 



If a file has no write permission and the standard input is 
a terminal, its permissions are printed and a line is read 
from the standard input. If that line begins with 'y' the 
file is deleted, otherwise the file remains. No questions 
are asked when the -f (force) option is given. 

If a designated file is a directory, an error comment is 
printed unless the optional argument -r has been used. In 
that case, rm recursively deletes the entire contents of the 
specified directory, and the directory itself. 

If the -i (interactive) option is in effect, rm asks whether 
to delete each file, and, under -r, whether to examine each 
directory. 

Rntdir removes entries for the named directories, which must 
be empty. 

ALSO 
unlink(2) 



DIAGNOSTICS 

Generally self-explanatory. It is forbidden 
file '..' merely to avoid the antisocial 
inadvertently doing something like ' rm -r .*' 



to remove the 
consequences of 
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NAME 



rmdel - remove a delta from an SCCS file 



SYNOPSIS 

rmdel 



•rSID files 



DESCRIPTION 

Rmdel removes the delta specified by the SID from each named 
SCCS file. The delta to be removed must be the newest (most 
recent) delta in its branch in the delta chain of each named 
SCCS file. In addition, the specified must not be that of 
a version being edited for the purpose of making a delta (i. 
e., if a p- f ile (see ^etd)) exists for the named SCCS file, 
the specified must not appear in any entry of the p- f ile ) . 

If a directory is named, rmdel behaves as though each file 
in the directory were specified as a named file, except that 
non-SCCS files (last component of the path name does not 
begin with s.) and unreadable files are silently ignored. 
If a name of - is given, the standard input is read; each 
line of the standard input is taken to be the name of an 
SCCS file to be processed; non-SCCS files and unreadable 
files are silently ignored. 

The exact permissions necessary to remove a delta are docu- 
mented in the Source Code Control System User 's Guide . Sim- 
ply stated, they are either (1) if you make a delta you can 
remove it; or (2) if you own the file and directory you can 
remove a delta. 



FILES 



x-file (see delta (l) ) 
z-file (see delta(l)) 



SEE ALSO , ^ 

delta(l), get(l), help(l), prs(l), sccsfile(5). 
Source Code Control System User 's Guide by L. E. Bonanni and 
C. A. Salemi. 



DIAGNOSTICS 

Use help (l) 



for explanations, 
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NAME 

roff - format text 

SYNOPSIS 

roff [ +n ] [ -n ] [ -s ] [ -h ] file ... 

nroff -mr [ option ] ... file ... 
troff -mr [ option ] ... file ... 

DESCRIPTION 

?^ ^?n'"^^L^®''- ^^^°r?i"9 to control lines embedded in the 
llll- ? • ^•''®" ^'^®^- Encountering a nonexistent file 
tnrnin offP'i'''-"^- ''}''°^^''^ inter-terSinal messages are 
turned off during printing. The optional flag arguments 

+n Start printing at the first page with number n. 

~S tln^ printing at the first page numbered highir than n. 

-s Stop before each page (including the first) to allSw 

signal. "'^'''^''^^^'°"' ''^^'^^ °'' receipt of an interrupt 

-h insert tabs in the output stream to replace spaces 
whenever appropriate. s»ftit.es 

input consists of intermixed text lines , which contain 

information to be formattPf^. ;,T;7r-?««TT^^T-i . „_"^\"^.. ^?"^^^" 

tai 

begj 

peri 



formation to be formatted, aHd Teqniit~ lines. which con- 

in instructions about how to for mat it . Riiuest lines 

gin^with a distinguished control charactg^^^nn^n,.'?;^! 

Output lines may be filled as nearly as possible with words 
without regard to ^H^ UneatiJn. Line breaks miy be 
caused at specified places by certain commands,— SF^byt hi 

wi?rrsplce! ^" ^""^"^ '"^''' ^'"^ °' ^" ^"P^" ^^"^ beginning 

The capabilities of roff are specified in the attached 
Request summary NumeFIHal values are denoted tSIre by n or 

h2;.^^^^ ^^ ^^ ^""^ ^^"5^^ characters by c. SOmbe^s 
denoted +n may be signed + or -, in which case they signify 
Inioi r ^^^"9es to a quantity, otherwise they signify an 
tnit ,^ resetting Missing n fields are ordinarily takin 
Iff td' "•^^^^^? t fields to be empty, and c fields to shS? 
off the appropriate special interpretation. 

Running titles usually appear at top and bottom of every 
page. They are set by requests like ^ 

.he 'partl'part2'part3' 

Parti is left justified, part2 is centered, and part3 is 
right justified on the page. Any % s gn in a ?itle is 
replaced by the current page number. Any nonblank may serie 
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as a quote. 

ASCII tab characters are replaced in the input by a replace- 
ment character , normally a space, according to the column 
settings given by a .ta command. (See .tr for how to con- 
vert this character on output.) 

Automatic hyphenation of filled output is done under control 
of .hy. When a word contains a designated hyphenation char- 
acter , that character disappears from the output and hyphens 
can be introduced into the word at the marked places only. 

The -mr option of nrof f or trof f (1) simulates rof f to the 
greatest extent possible. 



FILES 



/usr/lib/suftab suffix hyphenation tables 
/tmp/rtm? temporary 



RESTRICTIONS 

Roff is the simplest of the text formatting programs, 
utterly frozen. 



and is 



Request 
.ad 
.ar 
.br 


Break 
yes 
no 
yes 


Initial 

yes 

arabic 


.bl n 


yes 


- 


.bp +n 


yes 


n=l 


.cc c 
.ce n 


no 
yes 


c=. 



.de XX 



no 



.ds 


yes 


no 


.ef t 


no 


t= 


.eh t 


no 


t= 


.fi 


yes 


yes 


.fo 


no 


t= 


.he c 


no 


none 


.he t 


no 


t= 


.hx 


no 


- 


.hy n 


no 


n=l 



REQUEST SUMMARY 

Meaning 

Begin adjusting right margins. 

Arabic page numbers. 

Causes a line break the filling of the 

current line is stopped. 

Insert of n blank lines, on new page if 

necessary. 

Begin new page and number it n; no n 

means ' +1' . 



becomes ' c' . 
input lines, 



without 



ig 



no 



Control character 

Center the next n 

filling. 

Define parameterless macro to be invoked 

by request '.xx' (definition ends on 

line beginning '..'). 

Double space; same as '.Is 2'. 

Even foot title becomes t. 

Even head title becomes t. 

Begin filling output lines. 

All foot titles are t. 

Hyphenation character becomes 'c'. 

All head titles are t. 

Title lines are suppressed. 

Hyphenation is done, if n=l; and is not 

done, if n=0. 

Ignore input lines through a line 



ROFF ( 1 ) 



ROFFd) 



.m3 n no n=l 
.m4 n no n=3 



beginning with ' . . ' . 
.in +n yes - Indent n spaces from left margin. 
.IX +n no - Same as '.in' but without break, 
•li n no - Literal, treat next n lines as text. 
.11 +n no n=65 Line length including indent is n char- 
acters. 
.Is +n yes n=l Line spacing set to n lines per output 

line, 
•""l " rio n=2 Put n blank lines between the top of 

page and head title. 
•ni2 n no n=2 n blank lines put between head title and 

beginning of text on page. 

n blank lines put between end of text 

and foot title. 

n blank lines put between the foot title 

and the bottom of page, 
.na yes no Stop adjusting the right margin, 
.ne n no - Begin new page, if n output lines cannot 

fit on present page, 
.nn +n no - The next n output lines are not num- 
bered, 
•nl no no Add 5 to page offset; number lines in 

margin from 1 on each page. 
•"2 n no no Add 5 to page offset; number lines from 

n; stop if n=0. 
.ni +n no n=0 Line numbers are indented n. 
'^^ yes no Stop filling output lines, 

.nx file - Switch input to 'file', 
•of t no t= Odd foot title becomes t. 
•oh t no t= Odd head title becomes t. 
.pa +n yes n=l Same as ' .bp* . 

.pi +n no n=66 Total paper length taken to be n lines, 
.po +n no n=0 Page offset. All lines are preceded by 

n spaces. 
•J^o no arabic Roman page numbers, 
•sk n no - Produce n blank pages starting next 

page, 
.sp n yes - Insert block of n blank lines, except at 

top of page. 
•^s yes yes Single space output lines, equivalent to 

' .Is 1' . 
•t^ n n.. - Pseudotab settings. Initial tab set- 
tings are columns 9 17 25 ... 
•^9 <= "o space Tab replacement character becomes 'c'. 
.ti +n yes - Temporarily indent next output line n* 

spaces, 
.tr cdef.. no - Translate c into d, e into f, etc. 
.ul n no - Underline the letters and numbers in the 

next n input lines. 
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NAME 

rx2fmt - format RX02 floppy diskettes 

SYNOPSIS 

/etc/rx2fmt [-s] unit 

DESCRIPTION 

The rx2fmt command formats RX02 floppy diskettes for use in 
either single or double density mode. Single density mode 
provides RXOl compatibility. The '-s' option specifies sin- 
gle density, the default mode is double density. The 'unit' 
is the physical unit number of the RX02 drive to be used to 
format the diskette. 

FILES 

/dev/rhx# 

SEE ALSO 
hx(4) 
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NAME 

sa, accton - system accounting 

SYNOPSIS 

sa [ -abcjlnrstuv ] [ file ] 

/etc/accton [ file ] 

DESCRIPTION 

With an argument naming an existing file , accton causes sys- 
tem accounting information for every process executed to be 
placed at the end of the file. If no argument is given, 
accounting is turned off. 

Sa reports on, cleans up, and generally maintains accounting 
files. 

Sa is able to condense the information in / usr / adm / acct into 
a summary file / usr / adm / savacct which contains a count of 
the number of times each command was called and the time 
resources consumed. This condensation is desirable because 
on a large system acct can grow by 100 blocks per day. The 
summary file is read before the accounting file, so the 
reports include all available information. 

If a file name is given as the last argument, that file will 
be treated as the accounting file; sha is the default. 
There are zillions of options: 

a Place all command names containing unprintable charac- 
ters and those used only once under the name 
'***other, ' 

b Sort output by sum of user and system time divided by 
number of calls. Default sort is by sum of user and 
system times. 

c Besides total user, system, and real time for each com- 
mand print percentage of total time over all commands. 

j Instead of total minutes time for each category, give 
seconds per call. 

1 Separate system and user time; normally they are com- 
bined. 



m 



n 



Print number of processes and number of CPU minutes for 
each user. 

Sort by number of calls. 



r Reverse order of sort. 
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s Merge accounting file into summary file 
/ usr / adm / savacct when done. 

t For each command report ratio of real time to the sum 
of user and system times. 

u Superseding all other flags, print for each command in 
the accounting file the user ID and command name. 

V If the next character is a digit n, then type the name 
of each command used n times or fewer. Await a reply 
from the typewriter; if it begins with 'y', add the 
command to the category '**junk**.' This is used to 
strip out garbage. 

FILES 

/usr/adm/acct raw accounting 
/usr/adm/savacct summary 
/usr/adm/usracct per-user summary 

SEE ALSO 

ac(l), acct(2) 
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NAME 



sact - print current SCCS file editing activity 



SYNOPSIS 

sact files 

DESCRIPTION 

Sact informs the user of any impending deltas to a named 
sees file. This situation occurs when get (l) with the -e 
option has been previously executed without a subsequent 
execution of delta (l) . If a directory is named on the com- 
mand line, sact behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files 
and unreadable files are silently ignored. If a name of - 
is given, the standard input is read with each line being 
taken as the name of an SCCS file to be processed. The out- 
put for each named file consists of five fields separated by 
spaces. 



Field 1 

Field 2 
Field 3 

Field 4 
Field 5 



specifies the SID of a delta that currently 
exists in the SCCS file to which changes 
will be made to make the new delta. 



specifies 
created. 



the SID for the new delta to be 



contains the logname of the user who will 
make the delta (i.e. executed a get for 
editing) . 

contains the date that get -e was executed, 
contains the time that get -e was executed. 



SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help (l) for explanations. 
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NAME 

sccsdiff - compare two versions of an SCCS file 

SYNOPSIS 

sccsdiff -rSIDl -rSID2 [-p] [-sn] files 

DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates 
the differences between the two versions. Any number of 
SCCS files may be specified, but arguments apply to all 
files. 

-rSID? SIDl and SID2 specify the deltas of an SCCS 
file that are to be compared. Versions are 
passed to bdif f (1) in the order given. 

-p pipe output for each file through pr(l) . 

-sn n is the file segment size that bdif f will 
pass to dif f (1) . This is useful when diff 
fails due to a high system load. 

FILES 

/tmp/get????? Temporary files 

SEE ALSO 

bdiff(l), get(l), help(l), pr(l). 

Source Code Control System User 's Guide by L. E. Bonanni and 

C. A. Salemi. 

DIAGNOSTICS 

'file: No differences' If the two versions are the same. 



Use help (l) for explanations, 
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NAME 

script - make typescript of terminal session 

SYNOPSIS 

script [ -a ] [ -n ] [ -q ] [ -s ] [ -s shell ] [ file ] 

DESCRIPTION 

Script makes a typescript of everything printed on your ter- 
minal. The typescript is saved in a file, and can be sent 
to the line printer later with l^r. If file is given, the 
typescript is saved there. If not, the typescript is saved 
in the file typescript . 

To exit script , type control-D. This sends an end of file 
to all processes you have started up, and causes script to 
exit. For this reason, control-D behaves as though you had 
typed an infinite number of control-D' s. 

This program is useful when using a crt and a hard-copy 
record of the dialog is desired, as for a student handing in 
a program that was developed on a crt when hard-copy termi- 
nals are in short supply. The options are: 

-a Append to the typescript file instead of creating a new 
file. 

-n Use the 'new' shell (interpretation of 'new' is instal- 
lation dependent). 

-q Suppress the 'script started' and 'script done' mes- 
sages. 



-s 



Use the 'standard' shell (usually sh(l) ) . 



-S Use shell . If the requested shell is not available, 
script uses any shell it can find. 

AUTHOR 

Mark Horton 

RESTRICTIONS 

Since UNIX has no way to write an end-of-file down a pipe 
without closing the pipe, there is no way to simulate a sin- 
gle control-D without ending script . 

The new shell has its standard input coming from a pipe 
rather than a tty, so stty (l) will not work, and neither 
will ttyname (l) . 

When the user interrupts a printing process, script attempts 
to flush the output backed up in the pipe for better 
response. Usually the next prompt also gets flushed. 
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NAME 

sed - stream editor 

SYNOPSIS ^ ^ ^., T r .., , 

sed [ -n ] [ -e script ] [ -f sfile ] [ file J ... 

DESCR I PT I ON 

Sed copies the named files (standard input default) to the 
standard output, edited according to a script of commands. 
The -f option causes the script to be taken from file sfile ; 
these options accumulate. If there is just one -e option 
and no -f's, the flag -e may be omitted. The -n option 
suppresses the default output. 

A script consists of editing commands, one per line, of the 
following form: 

[address [, address] ] function [arguments] 

In normal operation sed cyclically copies a line of input 
into a pattern space (unless there is something left after a 
•D' command) , applies in sequence all commands whose 
addresses select that pattern space, and at the end of the 
script copies the pattern space to the standard output 
(except under -n) and deletes the pattern space. 

An address is either a decimal number that counts input 
linei cumulatively across files, a '$' that addresses the 
last line of input, or a context address, '/regular expres- 
sion/', in the style of ed(l) modified thus: 

The escape sequence '\n' matches a newline embedded in 
the pattern space. 

A command line with no addresses selects every pattern 
space. 

A command line with one address selects each pattern space 
that matches the address. 

A command line with two addresses selects the inclusive 
range from the first pattern space that matches the first 
address through the next pattern space that matches the 
second. (If the second address is a number less than or 
equal to the line number first selected, only one line is 
selected.) Thereafter the process is repeated, looking again 
for the first address. 

Editing commands can be applied only to non-selected pattern 
spaces by use of the negation function '!' (below). 
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In the following list of functions the maximum number of 
permissible addresses for each function is indicated in 
parentheses. 

An argument denoted text consists of one or more lines, all 
but the last of which end with 'N' to hide the newline. 
Backslashes in text are treated like backslashes in the 
replacement string of an 's' command, and may be used to 
protect initial blanks and tabs against the stripping that 
is done on every script line. 

An argument denoted rfile or wfile must terminate the com- 
mand line and must be preceded by exactly one blank. Each 
wfile IS created before processing begins. There can be at 
most 10 distinct wfile arguments. 

(l)a\ 
text 

Append. Place text on the output before reading the 
next input line. 

(2)b label 

Branch to the ':' command bearing the label . If label 
IS empty, branch to the end of the script. 

(2)c\ 

text 

Change. Delete the pattern space. With or 1 address 
or at the end of a 2-address range, place text on the 
output. Start the next cycle. 

(2)d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through 
the first newline. Start the next cycle. 

(2)g Replace the contents of the pattern space by the con- 
tents of the hold space. 

(2)G Append the contents of the hold space to the pattern 
space. ^ 

(2)h Replace the contents of the hold space by the contents 
of the pattern space. 

(2)H Append the contents of the pattern space to the hold 
space. 

(l)i\ 

^^g^t Insert. Place text on the standard output. 

(2)1 List the pattern space on the standard output in an 
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unambiguous form. Non-printing characters are spelled 
in two digit ascii, and long lines are folded. 

(2)n Copy the pattern space to the standard output. Replace 
the pattern space with the next line of input. 

(2)N Append the next line of input to the pattern space with 
an embedded newline. (The current line number 
changes. ) 

(2)p Print. Copy the pattern space to the standard output. 

(2)P Copy the initial segment of the pattern space through 
the first newline to the standard output. 

(l)q Quit. Branch to the end of the script. Do not start a 
new cycle. 

(2)r rfile 

Read the contents of rfile . Place them on the output 
before reading the next input line. 

(2)s/ regular express ion / replacement / flags 

Substitute the replacement string for instances of the 
regular expression in the pattern space. Any character 
may be used instead of '/'. For a fuller description 
see ed(l). Flags is zero or more of 

g Global. Substitute for all nonover lapping 
instances of the regular expression rather than 
just the first one. 

p Print the pattern space if a replacement was made. 

w wf ile 

Write. Append the pattern space to wf ile if a 
replacement was made. 

(2)t label 

Test. Branch to the ':' command bearing the label if 
any substitutions have been made since the most recent 
reading of an input line or execution of a 't'. If 
label is empty, branch to the end of the script. 

(2)w wf ile 

Write. Append the pattern space to wf ile . 

(2)x Exchange the contents of the pattern and hold spaces. 

( 2 ) y/ stringl / string2 / 

Transform. Replace all occurrences of characters in 
strinql with the corresponding character in string2 . 
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The lengths of strinql and strinq2 must be equal. 

(2) ! function 

Don't. Apply the function (or group, if function is 
'{') only to lines not selected by the address (es) . 

(0): label 

This command does nothing; it bears a label for 'b' and 
't' commands to branch to. 

(1)= Place the current line niraiber on the standard output as 
a line. 

(2){ Execute the following commands through a matching '}' 
only when the pattern space is selected. 

(0) An empty command is ignored. 

SEE ALSO 

ed{l), grep(l), awk(l) 
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NAME 

sh, for, case, if, while, :, ., break, continue, cd, eval, 
exec, exit, export, login, newgrp, read, readonly, set, 
shift, times, trap, umask, wait - command language 

SYNOPSIS 

sh [ -ceiknrstuvx ] [ arg ] ... 

DESCRIPTION 

Sh is a command programming language that executes commands 

read from a terminal or a file. See invocation for the 

meaning of arguments to the shell. 

Commands . 

A simple - command is a sequence of non blank words separated 
by blanks (a blank is a tab or a space). The first word 
specifies the name of the command to be executed. Except as 
specified below the remaining words are passed as arguments 
to the invoked command. The command name is passed as argu- 
ment (see exec (2) ) . The value of a simple-command is its 
exit status if it terminates normally or 200+status if it 
terminates abnormally (see signal (2) for a list of status 
values) . 

A pipeline is a sequence of one or more commands separated 
by T. The standard output of each command but the last is 
connected by a pipe (2) to the standard input of the next 
command. Each command is run as a separate process; the 
shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by 
; , St, StSt or II and optionally terminated by ; or &. ; and & 
have equal precedence which is lower than that of && and I I , 
ScSt and I I also have equal precedence. A semicolon causes 
sequential execution; an ampersand causes the preceding 
pipeline to be executed without waiting for it to finish. 
The symbol && (II) causes the list following to be executed 
only if the preceding pipeline returns a zero (non zero) 
value. Newlines may appear in a list , instead of semi- 
colons, to delimit commands. 

A command is either a simple-command or one of the follow- 
ing. The value returned by a command is that of the last 
simple-command executed in the command. 

for name [ in word . . . ] do list done 

Each time a for command is executed name is set to the 
next word in the for word list If in word ... is omit- 
ted then in "$(§" is assumed. Execution ends when there 
are no more words in the list. 
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case word in [ pattern [ | pattern ] . . . ) list ; ; ] ... esac 
A case command executes the list associated with the 
first pattern that matches word . The form of the pat- 
terns IS the same as that used for file name genera- 
tion. 

if list then list [elif list then list] ... [else list] fi 

The list following if is executed and if it returns 
zero the list following then is executed. Otherwise, 
the list following elif is executed and if its value is 
zero the list following then is executed. Failing that 
the else list is executed. 

while list [do list ] done 

A while command repeatedly executes the while list and 
if its value is zero executes the do list ; otherwise 
the loop terminates. The value returned by a while 
command is that of the last executed command in the do 
list, until may be used in place of while to negate the 
loop termination test. 

( list ) 

Execute list in a subshell. 

{ list } 

list is simply executed. 

The following words are only recognized as the first word of 
a command and when not quoted. 

if then else elif fi case in esac for while until do 
done { } 

Command substitution. 

The standard output from a command enclosed in a pair of 
grave accents (") may be used as part or all of a word; 
trailing newlines are removed. 

Parameter substitution. 

The character $ is used to introduce substitutable parame- 
ters. Positional parameters may be assigned values by set. 
Variables may be set by writing 

name = value [ name = value ] ... 

$ { parameter } 

A parameter is a sequence of letters, digits or under- 
scores (a name ), a digit, or any of the characters * @ 
# ? - $ !. The value, if any, of the parameter is sub- 
stituted. The braces are required only when paramet er 
IS followed by a letter, digit, or underscore that is 
not to be interpreted as part of its name. If 
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parameter is a digit then it is a positional parameter. 
If parameter is * or @ then all the positional parame- 
ters, starting with $1, are substituted separated by 
spaces. $0 is set from argument zero when the shell is 
invoked. 



$ { parameter - word } 

If parameter is set then substitute its 
wise substitute word. 



value; other- 



$ { parameter = word } 

If parameter is not set then set it to word; the value 
of the parameter is then substituted. Positional 
parameters may not be assigned to in this way. 

$ { parameter ? word } 

If parameter is set then substitute its value; other- 
wise, print word and exit from the shell. If word is 
omitted then a standard message is printed. 

$ { parameter + word } 

If parameter is set then substitute word ; otherwise 
substitute nothing. 

In the above word is not evaluated unless it is to be used 
as the substituted string. (So that, for example, echo 
${d-^pwd^} will only execute pwd if d is unset.) 

The following parameters are automatically set by the shell. 

# The nximber of positional parameters in decimal. 

Options supplied to the shell on invocation or by 

set. 
? The value returned by the last executed command in 

decimal. 
$ The process number of this shell. 
! The process number of the last background command 

invoked. 



The following parameters are used but not set by the shell, 



HOME The default argioment (home directory) for the cd 
command. 

The search path for commands (see execution). 
If this variable is set to the name of a mail file 
then the shell informs the user of the arrival of 
mail in the specified file. 
Primary prompt string, by default '$ '. 
Secondary prompt string, by default '> '. 
Internal field separators, normally space, tab, 
and newline. 



PATH 
MAIL 



PSl 
PS2 

IFS 



SH(1) SH(1) 



Blank interpretation. 

After parameter and command substitution, any results of 
substitution are scanned for internal field separator char- 
acters (those found in $IFS) and split into distinct argu- 
ments where such characters are found. Explicit null argu- 
ments ("" or ' ' ) are retained. Implicit null argxoments 
(those resulting from parameters that have no values) are 
removed. 

File name generation. 

Following substitution, each command word is scanned for the 
characters *, ? and [. If one of these characters appears 
then the word is regarded as a pattern. The word is 
replaced with alphabetically sorted file names that match 
the pattern. If no file name is found that matches the pat- 
tern then the word is left unchanged. The character . at 
the start of a file name or immediately following a /, and 
the character /, must be matched explicitly. 

* Matches any string, including the null string. 
? Matches any single character. 

Matches any one of the characters enclosed. A pair of 
characters separated by - matches any character lexi- 
cally between the pair. 

Quot i ng . 

The following characters have a special meaning to the shell 

and cause termination of a word unless quoted. 

; & ( ) I < > newline space tab 

A character may be quoted by preceding it with a \. \new- 
line is ignored. All characters enclosed between a pair of 
quote marks (''), except a single quote, are quoted. Inside 
double quotes ("") parameter and command substitution occurs 
and \ quotes the characters \ ' " and $. 

"$*" is equivalent to "$1 $2 ..." whereas 
"S@" is equivalent to "$1" "$2" ... . 

Prompting. 

When used interactively, the shell prompts with the value of 
PSl before reading a command. If at any time a newline is 
typed and further input is needed to complete a command then 
the secondary prompt ($PS2) is issued. 

Input output. 

Before a command is executed its input and output may be 
redirected using a special notation interpreted by the 
shell. The following may appear anywhere in a simple- 
command or may precede or follow a command and are not 
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passed on to the invoked command. Substitution occurs 
before word or digit is used. 

<word 

Use file word as standard input (file descriptor 0). 

> word 

Use file word as standard output (file descriptor 1). 
If the file does not exist then it is created; other- 
wise it is truncated to zero length. 

»word 

Use file word as standard output. If the file exists 
then output is appended (by seeking to the end); other- 
wise the file is created. 

«word 

The shell input is read up to a line the same as word, 
or end of file. The resulting document becomes the 
standard input. If any character of word is quoted 
then no interpretation is placed upon the characters of 
the docxament; otherwise, parameter and command substi- 
tution occurs, \newline is ignored, and \ is used to 
quote the characters \ $ ' and the first character of 
word. 

<& digit 

The standard input is duplicated from file descriptor 
digit ; see dup ( 2 ) . Similarly for the standard output 
using >. 

<&- The standard input is closed. Similarly for the stan- 
dard output using >. 

If one of the above is preceded by a digit then the file 
descriptor created is that specified by the digit (instead 
of the default or 1). For example, 

... 2>Scl 

creates file descriptor 2 to be a duplicate of file descrip- 
tor 1. 

If a command is followed by & then the default standard 
input for the command is the empty file (/dev/null). Other- 
wise, the environment for the execution of a command con- 
tains the file descriptors of the invoking shell as modified 
by input output specifications. 

Environment. 

The environment is a list of name-value pairs that is passed 

to an executed program in the same way as a normal argument 
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list; see exec (2) and environ (5) . The shell interacts with 
the environment in several ways. On invocation, the shell 
scans the environment and creates a parameter for each name 
found, giving it the corresponding value. Executed commands 
inherit the same environment. If the user modifies the 
values of these parameters or creates new ones, none of 
these affects the environment unless the export command is 
used to bind the shell's parameter to the environment. The 
environment seen by any executed command is thus composed of 
any unmodified name-value pairs originally inherited by the 
shell, plus any modifications or additions, all of which 
must be noted in export commands. 

The environment for any s imple - command may be augmented by 
prefixing it with one or more assignments to parameters . 
Thus these two lines are equivalent 

TERM=450 cmd args 

(export TERM; TERM=450; cmd args) 

If the -k flag is set, all keyword arguments are placed in 
the environment, even if the occur after the command name. 
The following prints 'a=b c' and 'c': 
echo a=b c 
set -k 
echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals 
have the values inherited by the shell from its parent. 
(But see also trap. ) 

Execution. 

Each time a command is executed the above substitutions are 
carried out. Except for the 'special commands' listed below 
a new process is created and an attempt is made to execute 
the command via an exec (2) . 

The shell parameter $PATH defines the search path for the 
directory containing the command. Each alternative direc- 
tory name is separated by a colon (:). The default path is 
:/bin:/usr/bin. If the command name contains a / then the 
search path is not used. Otherwise, each directory in the 
path is searched for an executable file. If the file has 
execute permission but is not an a. out file, it is assumed 
to be a file containing shell commands. A subshell (i.e., a 
separate process) is spawned to read it. A parenthesized 
command is also executed in a subshell. 

Special commands. 

The following commands are executed in the shell process and 
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except where specified no input output redirection is per- 
mitted for such commands. 

: No effect; the command does nothing. 

. file 

Read and execute commands from file and return. The 
search path $PATH is used to find the directory con- 
taining file . 

break [n] 

ExTt from the enclosing for or while loop, if any. If 
n is specified then break n levels. 

continue [n] 

Resume the next iteration of the enclosing for or while 
loop. If n is specified then resume at the n-th 
enclosing loop. 

cd [ arg ] 

Change the current directory to arg . The shell parame- 
ter $HOME is the default arg . 

eval [ arg . , . ] 

The arguments are read as input to the shell and the 
resulting command(s) executed. 

exec [ arg . . . ] 

The command specified by the arguments is executed in 
place of this shell without creating a new process. 
Input output arguments may appear and if no other argu- 
ments are given cause the shell input output to be 
mod i f i ed . 

exit [n] 

Causes a non interactive shell to exit with the exit 
status specified by n. If n is omitted then the exit 
status is that of the last command executed. (An end 
of file will also exit from the shell.) 

export [name . . . ] 

The given names are marked for automatic export to the 
environment of subsequently-executed commands. If no 
argijments are given then a list of exportable names is 
printed. 

login [ arg ...] 

Equivalent to 'exec login arg ...'. 

newgrp [ arg . . . ] 

Equivalent to 'exec newgrp arg ...'. 

read name . . . 

One line is read from the standard input; successive 
words of the input are assigned to the variables name 
in order, with leftover words to the last variable. 
The return code is unless the end-of-file is encoun- 
tered. 

readonly [ name . . . ] 

The given names are marked readonly and the values of 
the these names may not be changed by subsequent 
assignment. If no arguments are given then a list of 
all readonly names is printed. 
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set [-eknptuvx [ arg ...]] 

-e If non interactive then exit immediately if a com- 
mand fails. 

-k All keyword arguments are placed in the environment 
for a command, not just those that precede the com- 
mand name. 

-n Read commands but do not execute them. 

-t Exit after reading and executing one command. 

-u Treat unset variables as an error when substituting. 

-V Print shell input lines as they are read. 

-x Print commands and their arguments as they are exe- 
cuted. 

- Turn off the -x and -v options. 

These flags can also be used upon invocation of the 
shell. The current set of flags may be found in $-. 

Remaining arguments are positional parameters and are 
assigned, in order, to $1, $2, etc. If no arguments 
are given then the values of all names are printed. 

shift 

The positional parameters from $2... are renamed $1... 

times 

Print the accumulated user and system times for 
processes run from the shell. 

trap [ arg ] [n] . . . 

Arg is a command to be read and executed when the shell 
receives signal(s) n. (Note that arg is scanned once 
when the trap is set and once when the trap is taken.) 
Trap commands are executed in order of signal number. 
If arg is absent then all trap(s) n are reset to their 
original values. If arg is the null string then this 
signal is ignored by the shell and by invoked commands. 
If n is then the command arg is executed on exit from 
the shell, otherwise upon receipt of signal n as num- 
bered in signal (2) . Trap with no argxjments prints a 
list of commands associated with each signal number. 

umask [ nnn ] 

The user file creation mask is set to the octal value 
nnn (see umask (2) ) . If nnn is omitted, the current 
value of the mask is printed. 

wait [n] 

Wait for the specified process and report its termina- 
tion status. If n is not given then all currently 
active child processes are waited for. The return code 
from this command is that of the process waited for. 
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Invocation. 

If the first character of argument zero is -, commands are 

read from $HOME/.prof ile, if such a file exists. Commands 

are then read as described below. The following flags are 

interpreted by the shell when it is invoked. 

-c string If the -c flag is present then commands are read 
from string . 

-s If the -s flag is present or if no arguments 
remain then commands are read from the standard 
input. Shell output is written to file descrip- 
tor 2. 

-i If the -i flag is present or if the shell input 
and output are attached to a terminal (as told by 
gtty ) then this shell is interactive . In this 
case the terminate signal SIGTERM (see signal (2)) 
is ignored (so that 'kill 0' does not kill an 
interactive shell) and the interrupt signal SIG- 
INT is caught and ignored (so that wait is inter- 
ruptable). In all cases SIGQUIT is ignored by 
the shell. 

The remaining flags and arguments are described under the 
set command. 

FILES 

$HOME/. prof ile 

/tmp/sh* 

/dev/null 

SEE ALSO 

test(l), exec(2), 

DIAGNOSTICS 

Errors detected by the shell, such as syntax errors cause 
the shell to return a non zero exit status. If the shell is 
being used non interactively then execution of the shell 
file is abandoned. Otherwise, the shell returns the exit 
status of the last command executed (see also exit). 

RESTRICTIONS 

If « is used to provide standard input to an asynchronous 
process invoked by &, the shell gets mixed up about naming 
the input document. A garbage file /tmp/sh* is created, and 
the shell complains about not being able to find the file by 
another name. 
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NAME 

size - size of an object file 

SYNOPSIS 

size [ object ... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the 
text, data, and bss portions, and their sum in octal and 
decimal, of each object-file argument. For overlay text 
files (0430 or 0431) size prints the (decimal) number of 
bytes contained in the root text segment, each overlay text 
segment, the data and bss segments, the sum of the root, 
data, and bss segments, and the total text size. If no file 
is specified, a. out is used. 

SEE ALSO 

a.out(5) 
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NAME 

sleep - suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to 
execute a command after a certain amount of time as in: 

(sleep 105; command) & 

or to execute a command every so often, as in: 

while true 
do 

command 

sleep 37 
done 

SEE ALSO 

alarm{2), sleepO) 

RESTRICTIONS 

Time must be less than 65536 seconds. 
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NAME 



sort - sort or merge files 



SYNOPSIS 

sort [ - mubdfinrt x ] [ +posl [ -pos2 ] ] 
-T directory J L name ] ... 



[ -o name ] [ 



DESCRIPTION 

Sort sorts lines of all the named files together and writes 
the result on the standard output. The name '-' means the 
standard input. If no input files are named, the standard 
input IS sorted. 

The default sort key is an entire line. Default ordering is 
lexicographic by bytes in machine collating sequence. The 
ordering is affected globally by the following options, one 
or more of which may appear. 



Ignore leading blanks (spaces and tabs) 
pari sons. 



in field com- 



f 
i 

n 



'Dictionary' order: only letters, digits and blanks are 
significant in comparisons. 

Fold upper case letters onto lower case. 

Ignore characters outside the ASCII range 040-0176 in 
nonnumeric comparisons. 

An initial numeric string, consisting of optional 
blanks, optional minus sign, and zero or more digits 
with optional decimal point, is sorted by arithmetic 
value. Option n implies option b. 

r Reverse the sense of comparisons. 

tx 'Tab character' separating fields is x. 

The notation + posl - pos2 restricts a sort key to a field 
beginning at posl and ending just before pos2 . Posl and 
£os2 each have the form m.n, optionally followed by "one or 
more of the flags bdfinr, where m tells a number of fields 
to skip from the beginning of the line and n tells a number 
of characters to skip further. If any flags are present 
they override all the global ordering options for this key 
^^ w!^^^ ^ option is in effect n is counted from the first 
nonblank in the field; b is attached independently to pos2. 
A missing .n means .0; a missing - pos2 means the end ofThe 
line. Under the -tx option, fields are strings separated by 
x; otherwise fields are nonempty nonblank strings separated 
by blanks. 
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When there are multiple sort keys, later keys are compared 
only after all earlier keys compare equal. Lines that oth- 
erwise compare equal are ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the 
ordering rules; give no output unless the file is out 
of sort. 



m 
o 



u 



Merge only, the input files are already sorted. 

The next argument is the name of an output file to use 
instead of the standard output. This file may be the 
same as one of the inputs. 

The next argument is the name of a directory in which 
temporary files should be made. 

Suppress all but one in each set of equal lines. 
Ignored bytes and bytes outside keys do not participate 
in this comparison. 

Examples. Print in alphabetical order all the unique spel- 
lings in a list of words. Capitalized words differ from 
uncapitalized. 

sort -u +0f +0 list 

Print the password file ( passwd (5) ) sorted by user id number 
(the 3rd colon-separated field) . 

sort -t: +2n /etc/passwd 

Print the first instance of each month in an already sorted 
file of (month day) entries. The options -um with just one 
input file make the choice of a unique representative from a 
set of equal lines predictable. 

sort -um +0 -1 dates 

FILES 

/usr/tmp/stm*, /tmp/*: first and second tries for temporary 

files 

SEE ALSO 

uniq(l), comm(l), rev(l), join(l) 
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DIAGNOSTICS 

Comments and exits with nonzero status for various trouble 
conditions and for disorder discovered under option -c. 

RESTRICTIONS 

Very long lines are silently truncated. 
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NAME 

spell, spellin, spellout - find spelling errors 

SYNOPSIS 

spell [ option ] ... [ file ] ... 

/usr/lib/spellin [ list ] 

/usr/lib/spellout [ -d ] list 

DESCRIPTION 

Spell collects words from the named documents, and looks 
them up in a spelling list. Words that neither occur among 
nor are derivable (by applying certain inflections, prefixes 
or suffixes) from words in the spelling list are printed on 
the standard output. If no files are named, words are col- 
lected from the standard input. 

Spell ignores most trof f , tbl and eqn (l) constructions. 

Under the -v option, all words not literally in the spelling 
list are printed, and plausible derivations from spelling 
list words are indicated. 

Under the -b option, British spelling is checked. Besides 
preferring centre, colour, speciality , travelled , etc., this 
option insists upon - ise in words like standardise . Fowler 
and the OED to the contrary notwithstanding. 

Under the -x option, every plausible stem is printed with 
'=' for each word. 

The spelling list is based on many sources, and while more 
haphazard than an ordinary dictionary, is also more effec- 
tive in respect to proper names and popular technical words. 
Coverage of the specialized vocabularies of biology, medi- 
cine and chemistry is light. 

Pertinent auxiliary files may be specified by name argu- 
ments, indicated below with their default settings. Copies 
of all output are accumulated in the history file. The stop 
list filters out misspellings (e.g. thier=thy-y+ier) that 
would otherwise pass. 

Two routines help maintain the hash lists used by spell . 
Both expect a list of words, one per line, from the standard 
input. Spellin adds the words on the standard input to the 
preexisting list and places a new list on the standard out- 
put. If no list is specified, the new list is created from 
scratch. Spellout looks up each word in the standard input 
and prints on the standard output those that are missing 
from (or present on, with option -d) the hash list. 
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To create the basic hashed spelling list: 

cd /usr/lib; spell in < /us r /diet/words >hlist 

To create the American hashed spelling list: 

cd /usr/lib; (cat american local) Ispellin hlist >hlista 

To create the British hashed spelling list: 

cd /usr/lib; (cat british local) | spellin hlist >hlistb 

FILES 

SPELL_D=/usr/dict/hlist[ab]: hashed spelling lists, American 
& British 

SPELL_S=/usr/dict/hstop: hashed stop list 

SPELL_H=/usr/dict/spellhist: history file 

/usr/dict/words: full dictionary 

/usr/dict/american: american spelling 

/usr/dict/british: british spelling 

/usr/dict/local: local spelling 

/usr/lib/spell 

/usr/lib/spellin 

/usr/lib/spellout 

deroff(l), sort(l), tee(l), sed(l) 

Note: spell searches the user's environment for variables of 
the form 'SHELL_X', if found, it uses those by default. 

RESTRICTIONS 

The spelling list's coverage is uneven; new installations 
will probably wish to monitor the output for several months 
to gather local additions. 
British spelling was done by an American. 
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NAME 

spline - interpolate smooth curve 

SYNOPSIS 

spline [ option ] ... 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as 
abcissas and ordinates of a function. It produces a similar 
set, which is approximately equally spaced and includes the 
input set, on the standard output. The cubic spline output 
(R. W. Hamming, Numerical Methods for Scientists and 
Engineers , 2nd ed. , 349ff) has two continuous derivatives, 
and sufficiently many points to look smooth when plotted, 
for example by graph (l) . 

The following options are recognized, each as a separate 
argument . 

-a Supply abscissas automatically (they are missing from 
the input); spacing is given by the next argximent, or 
is assumed to be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation 
(2nd deriv. at end) = k*(2nd deriv. next to end) 

is set by the next argument. By default k = 0, 

-n Space output points so that approximately n intervals 
occur between the lower and upper x limits. (Default n 
= 100.) 

-p Make output periodic, i.e. match derivatives at ends. 
First and last input values should normally agree. 

-x Next 1 (or 2) arguments are lower (and upper) x limits. 
Normally these limits are calculated from the data. 
Automatic abcissas start at lower limit (default 0). 

SEE ALSO 

graph(l) 

DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces 
the input without interpolating extra points. 

RESTRICTIONS 

A limit of 1000 input points is enforced silently. 



SPL^^^l^ SPLIT(l) 



NAME 

split - split a file into pieces 

SYNOPSIS 

split t -n ] [ file [ name ] ] 

DESCRIPTION 

S£lit reads file and writes it in n-line pieces (default 
1000), as many as necessary, onto a set of output files. 
The name of the first output file is name with aa appended, 
and so on lexicographically. If no output name is given, x 
IS default. 

If no input file is given, or if - is given in its stead, 
then the standard input file is used. 
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NAME 

strings - find the printable strings in a object, or other 
binary, file 

SYNOPSIS 

strings [-][-©][ - number ] file ... 

DESCRIPTION 

Strings looks for ascii strings in a binary file. A string 
IS any sequence of 4 or more printing characters ending with 
a newline or a null. Unless the - flag is given, strings 
only looks in the initialized data space of object files. 
If the -o flag is given, then each string is preceded by its 
offset in the file (in octal). If the - number flag is given 
then number is used as the minimum string length rather than 
4. 

Strings is useful for identifying random object files and 
many other things. 

SEE ALSO 
Odd) 

AUTHOR 

Bill Joy 

RESTRICTIONS 

The algorithm for identifying strings is extremely primi- 
tive. 
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NAME 

Strip - remove symbols and relocation bits 

SYNOPSIS 

strip name . . . 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordi- 
narily attached to the output of the assembler and loader. 
This is useful to save space after a program has been 
debugged. 

The effect of strip is the same as use of the -s option of 
Id. 

Strip automatically accommodates overlay text files (0430 or 
0431). 

FILES 

/tmp/stm? temporary file 

SEE ALSO 

ld(l) 
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NAME 



Struct - structure Fortran programs 



SYNOPSIS 

struct 

DESCRIPTION 
Struct 



[ option ] 



file 



translates the Fortran program specified by file 
(standard input default) into a Ratfor program. Wherever 
possible, Ratfor control constructs replace the original 
Fortran. Statement numbers appear only where still neces- 
sary. Cosmetic changes are made, including changing Holler- 
ith strings into quoted strings and relational operators 
into symbols (.e.g. '.GT.' into '>'). The output is 
appropriately indented. 

The following options may occur in any order. 

-s Input is accepted in standard format, i.e. comments 
are specified by a c, C, or * in column 1, and con- 
tinuation lines are specified by a nonzero, nonblank 
character in column 6. Normally, a statement whose 
first nonblank character is not alphanumeric is treated 
as a continuation. 

-i Do not turn computed goto statements into switches. 
(Ratfor does not turn switches back into computed goto 
statements. ) 

-a Turn sequences of else ifs into a non-Ratfor switch of 
the form 



switch { 

case predl: code 
case pred2: code 
case pred3: code 
default: code 
} 

The case predicates are tested in order; 
appropriate to only one case is executed, 
eralized form of switch statement does not 
Ratfor. 



the code 
This gen- 
occur in 



-b Generate goto's instead of multilevel break statements. 

-n Generate goto's instead of multilevel next statements. 

-en If n is (default), place code within a loop only if 
it can lead to an iteration of the loop. If n is 
nonzero, admit code segments with fewer than n 
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Statements to a loop if otherwise the loop would have 
exits to several places including the segment, and the 
segment can be reached only from the loop. 



FILES 



/tmp/struct* 
/usr/1 ib/st ruct/* 

SEE ALSO 

f77(l) 

RESTRICTIONS 

Struct knows Fortran 66 syntax, but not full Fortran 77 
(alternate returns, IF. . .THEN. . .ELSE, etc.) 

If an input Fortran program contains identifiers which are 
reserved words in Ratfor, the structured version of the pro- 
gram will not be a valid Ratfor program. 
Extended range DO's generate cryptic errors. 
Columns 73-80 are not special even when -s is in effect. 
Will not generate Ratfor FOR statements. 
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NAME 



stty - set terminal options 



SYNOPSIS 
Stty 



[ option 



] 



DESCRIPTION 

Stty sets certain I/O options on the current output termi- 
nal, placing its output on the diagnostic output. With no 
argument, it reports the speed of the terminal and the set- 
tings of the options which are different from their 
defaults. With the argument 'all', all normally used option 
settings are reported. With the argxoment 'everything', 
everything stty knows about is printed. The option strings 
are selected from the following set: 



even 

-even 

odd 

-odd 

raw 

-raw 

cooked 

cbreak 



-cbreak 

-nl 

nl 

echo 

-echo 

lease 

-lease 

tandem 



allow even parity input 

disallow even parity input 

allow odd parity input 

disallow odd parity input 

raw mode input (no input processing (erase, 

interrupt, ...); parity bit passed back) 

negate raw mode 

same as 

make each 

received; 



kill. 



' -raw' 

character 
no erase 



to 



available 
and kill processing. 



read (2) 
but 



as 

all 



) is per- 



( interrupt, suspend, 

to read only when new- 



and output 



-tandem 
-tabs 
tabs 
ek 



other processing 

formed 

make characters available 

line is received 

allow carriage return for new-line, 

CR-LF for carriage return or new-line 

accept only new-line to end lines 

echo back every character typed 

do not echo characters 

map upper case to lower case 

do not map case 

enable flow control, so that the system sends out 

the stop character when its internal queue is in 

danger of overflowing on input, and sends the 

start character when it is ready to accept further 

input 

disable flow control 

replace tabs by spaces when printing 

preserve tabs 

set erase and kill characters to # and @ 



For the following commands which take a character argument 
c, you may also specify c as the 'u' or 'undef, to set the 
value to be undefined. A value of '^x', a 2 character 
sequence, is also interpreted as a control character, with 
representing delete. 



I /\-j I 
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erase c 

kill c 

intr c 

quit c 
start c 
stop c 
eof c 

brk c 

crO crl c 

nlO nil n 

tabO tabl 

ffO ffl 
bsO bsl 

tty33 

tty37 

vt05 

dec 



to c (default '#' , 



set erase character 

reset to -^H. ) 

set kill character to c (default 

reset to '^U. ) 

set interrupt character to c (default 

(delete), but often reset to ''C.) 

set quit character to c (default control \.) 
start character to c (default control Q. ) 
stop character to c (default control S.) 
end of file character to c (default control 



but often 

but often 

DEL or ^7 



set 

set 

set 

D.) 

set break character to c (default undefined.) This 

character is an extra wakeup causing character. 
r2 cr3 

select style of delay for carriage 

ioctl(2)) 
12 nl3 

select style of delay for linefeed 

tab2 tab3 

select style of delay for tab 

select style of delay for form feed 

select style of delay for backspace 



return (see 



the 



suitable for 

terminal. 

suitable for 

terminal. 

suitable for Digital Equipment Corp. 



the 



Teletype 
Teletype 



Corpora- 
Corpora- 



tn300 

ti700 

tek 



50 75 



110 



set all modes 
tion Model 33 
set all modes 
tion Model 37 
set all modes 
VT05 terminal 
set all modes suitable for Digital Equipment Corp. 
operating systems users; (erase, kill, and inter- 
rupt characters to ^1 , ^U, and ^C, decctlq and 
'newcrt' . ) 

set all modes suitable for a General Electric Ter- 

miNet 300 

set all modes suitable for Texas Instruments 700 

series terminal 

set all modes suitable for Tektronix 4014 terminal 

hang up phone line immediately 

134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 

Set terminal baud rate to the number given, if 

possible. (These are the speeds supported by the 

DH-11 interface). 



A teletype driver which supports the job control processing 
of csh (l) with more functionality than the basic driver is 
introduced in newtty (4) and fully described in tty (4) . The 
following options apply only to it. 



new 
old 



Use new driver (switching flushes typeahead) 
Use old driver (switching flushes typeahead) 
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crt 

crtbs 
prterase 

crterase 

-crterase 

crtkill 

-crtkill 

ctlecho 



-ctlecho 
decctlq 

-decctlq 

tostop 

-tostop 

tilde 

-tilde 
flusho 

-flusho 
pendin 



-pendin 
intrup 



-intrup 
mdmbuf 

-mdmbuf 

litout 
-litout 



Set options for a CRT (crtbs, ctlecho and, if >= 
1200 baud, crterase and crtkill.) 
Echo backspaces on erase characters. 
For printing terminal echo erased characters back- 
wards within 'X' and '/'. 

Wipe out erased characters with 'backspace-space- 
backspace. ' 

Leave erased characters visible; just backspace. 
Wipe out input on like kill ala crterase. 
Just echo line kill character and a newline on 
line kill. 

Echo control characters as '"^x' (and delete as 
"^T'.) Print two backspaces following the EOT 
character (control D) . 

Control characters echo as themselves; in cooked 
mode EOT (control-D) is not echoed. 

After output is suspended (normally by '^S) , only a 
start character (normally "^Q) will restart it. 
This is compatible with DEC's vendor supplied sys- 
tems. 

After output is suspended, any character typed 
will restart it; the start character will restart 



any 



the 



input. (This is 

attempt terminal out- 

the terminal is 



to 



(for Hazeltine termi- 



hit 



output without providing 

default. ) 

Background jobs stop if they 

put. 

Output from background jobs 

allowed. 

Convert '~' to '"' on output 

nals) . 

Leave poor '~' alone. 

Output is being discarded usually because user 

control (internal state bit). 

Output is not being discarded. 

Input is pending after a switch from cbreak to 

cooked and will be re- input when a read becomes 

pending or more input arrives (internal state 

bit). 

Input is not pending. 

Send a signal (SIGTINT) to the terminal control 

process group whenever an input record (line in 

cooked mode, character in cbreak or raw mode) is 

available for reading. 

Don't send input available interrupts. 

Start/stop output on carrier transitions (not 

implemented) . 

Return error if write attempted after carrier 

drops. 

Send output characters without any processing. 

Do normal output processing, inserting delays, 
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etc. 
etxack Diablo style etx/ack handshaking (not imple- 
mented) . 

The following special characters are applicable only to the 
new teletype driver and are not normally changed. 

susp c set suspend process character to c (default con- 
trol Z.) 

dsusp c set delayed suspend process character to c 

(default control Y.) ~ 

rprnt c set reprint line character to c (default control 
R.) 



flush c set flush output character to c (default control 

0.) 

werase c set word erase character to c (default control W. ) 

Inext c set literal next character to c (default control 



SEE ALSO 

tabs(l), tset(l), ioctl(2), newtty(4), tty(4) 
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NAME 

su - substitute user id temporarily 

SYNTAX 

su [ - ] [ userid ] 

DESCRIPTION 

Su demands the password of the specified userid , and if it 
IS given, changes to that userid and invokes a shell without 
changing the current directory or the user environment. The 
new user ID stays in force until the shell exits. If the 
'SHELL' environment variable is set, it is used as the name 
of the new shell, and, if necessary, the previous user 
environment is restored for that shell. This allows for the 
use of multiple shells with su. If the optional - flag is 
given, the shell of the specified user will be the new 
shell, the environment is set as for that user, and the new 
shell is started in the new home directory. This can be 
used to simulate the login environment of a specified user. 

If no userid is specified, 'root' is assumed. If the file 
/usr/adm/sulog exists, records are kept there of all su 
attempts to the root id. To remind the super-user of his 
responsibilities, the shell substitutes '#' for its usual 
prompt . 

FILES 

/usr/adm/sulog 

SEE ALSO 

csh(l), newgrp(l), sh(l) 
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NAME 

sum - Sim and count blocks in a file 

SYNOPSIS 

sum file 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named 
file, and also prints the number of blocks in the file. It 
is typically used to look for bad spots, or to validate 
file communicated over some transmission line. 



a 



SEE ALSO 

wc(l) 

DIAGNOSTICS 



'Read error' is indistinguishable from end of file on most 
devices; check the block count. 
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NAME 

sync - update the super block 

SYNOPSIS 
sync 

DESCRIPTION 

Sync executes the sync system primitive. If the system is 
to — be stopped, sync must be called to insure file system 
integrity. See sync (2 ) for details. 

SEE ALSO 

sync(2), update(8) 
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NAME 

sysgen - ULTRIX-11 system generation 

SYNOPSIS 

sysgen 



DESCRIPTION 



Refer to the ULTRIX-11 System Management Guide, Chapter 2 
tor a description of the system generation process. 



SEE ALSO 

mkconf ( 1 ) 
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NAME 

tabs - set terminal tabs 

SYNOPSIS 

tabs [ -n ] [ terminal ] 

DESCRIPTION 

Tabs sets the tabs on a variety of terminals. Various of 
the terminal names given in term (7) are recognized; the 
default is, however, suitable for most 300 baud terminals. 
If the -n flag is present then the left margin is not 
indented as is normal. 

SEE ALSO 

sttyd), term(7) 
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NAME 

tail - deliver the last part of a file 

SYNOPSIS 

tail +number[lbc][rf ] [ file ] 

DESCRIPTION 

Tail copies the named file to the standard output beginning 
at a designated place. If no file is named, the standard 
input is used. 

Copying begins at distance + number from the beginning, or 
- number from the end of the input. Number is counted in 
units of lines, blocks or characters, according to the 
appended option 1, b or c. When no units are specified, 
counting is by lines. 

Specifying r causes tail to print lines from the end of the 
file in reverse order. The default for r is to print the 
entire file this way. Specifying f causes tail to not quit 
at end of file, but rather wait and try to read repeatedly 
in hopes that the file will grow. 

SEE ALSO 
dd(l) 

RESTRICTIONS 

Tails relative to the end of the file are treasured up in a 
buffer, and thus are limited in length. 

Various kinds of anomalous behavior may happen with charac- 
ter special files. 
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NAME 

tar - tape archiver 

SYNOPSIS 

tar [ key ] [ name ... ] 

DESCRIPTION 

Tar saves and restores files on magtape or RX50 floppy 
diskette. Its actions are controlled by the key argument. 
The key is a string of characters containing at most one 
function letter and possibly one or more function modifiers. 
Other arguments to the command are file or directory names 
specifying which files are to be dumped or restored. In all 
cases, appearance of a directory name refers to the files 
and (recursively) subdirectories of that directory. Tar 
also saves and restores special files . 

The function portion of the key is specified by one of the 
following letters: 

r The named files are written on the end of the tape. 
The c function implies this. Writing files on the 
end of a tar tape creates a second archive on that 
tape. Using the r option with a tape where the 
second archive already exists will overwrite the 
second archive, not create a third archive. Dealing 
with the second archive can be clumsy, i.e., the no 
rewind on close tape special file must be used to 
position the tape after the first archive. For exam- 
ple: 

tar tf /dev/nrhtO >/dev/null 

X The named files are extracted from the tape. If the 
named file matches a directory whose contents had 
been written onto the tape, this directory is 
(recursively) extracted. The owner, modification 
time, and mode are restored (if possible). If no 
file argument is given, the entire content of the 
tape is extracted. Note that if multiple entries 
specifying the same file are on the tape, the last 
one overwrites all earlier. 

t The names of the specified files are listed each 
time they occur on the tape. If no file argument is 
given, all of the names on the tape are listed. 

u The named files are added to the tape if either they 
are not already there or have been modified since 
last put on the tape. The files are appended to the 
end of the tape (see r above). 
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c Create a new tape; writing begins on the beginning 
of the tape instead of after the last file. This 
command implies r. 

The following characters may be used in addition to the 
letter which selects the function desired. 

0,...,7 This modifier selects the drive on which the tape 
is mounted. The default is 0. 

V Normally tar does its work silently. The v (ver- 
bose) option causes it to type the name of each 
file it treats preceded by the function letter. 
With the t function, v gives more information 
about the tape entries than just the name. 

w causes tar to print the action to be taken fol- 
lowed by file name, then wait for user confirma- 
tion. If a word beginning with 'y' is given, the 
action is performed. Any other input means don't 
do it. 

f causes tar to use the next argument as the name of 
the archive instead of /dev/rmt? or /dev/rht?, for 
example, tar could archive to an RX50 floppy 
diskette with the command 

tar cf /dev/rrx? files 
If the name of the file is '-', tar writes to 
standard output or reads from standard input, 
whichever is appropriate. Thus, tar can be used as 
the head or tail of a filter chain Tar can also be 
used to move hierarchies with the command 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

b causes tar to use the next argument as the block- 
ing factor for tape records. The default is 1, the 
maximum is 20. This option should only be used 
with raw magnetic tape archives or with raw disk 
archives that will never be updated, e.g., RX50 
diskettes. The block size is determined automati- 
cally when reading tape and disk archives (key 
letters 'x' and 't'), unless both the 'b' and 'f 
keys are specified. In that case the blocking 
factor specified by the 'b' key is used uncondi- 
tionally. 

1 tells tar to complain if it cannot resolve all of 
the links to the files dumped. If this is not 
specified, no error messages are printed. 

m tells tar to not restore the modification times. 
The mod time will be the time of extraction. 
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n 



FILES 



Select (NRZI) 800 BPI density on 
tape unit, /dev/rmtO by default. 



the specified 



Changes the mode of extracted files to the origi- 
nal mode, as written to tape. By default, the tar 
user's mode is passed to the file. 

Suppress the normal directory information. On 
output, tar normally places information specifying 
owner and mode of directories. This allows tar to 
extract the files even if the top level directory 
does not exist. 

Selects the RX50 diskettes as the tar medium, 
/dev/rrxO by default. In addition, the blocking 
factor is established as 10, unless otherwise 
specified. 



/dev/rmt? 
/dev/rht? 
/dev/rrx? 
/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write 
errors. 

Complaints if enough memory is not available to hold the 
link tables. 



RESTRICTIONS 

There is no way to ask for the n-th occurrence of a file. 
Tape errors are handled ungracefully. 

The b option should not be used with archives that are going 
to be updated. The current magtape driver cannot backspace 
raw magtape. If the archive is on a disk file the b option 
should not be used at all, as updating an archive stored in 
this manner can destroy it. The b option may be used with 
raw disk archives if and only if those archives will never 
be updated. 

The current limit on file name length is 100 characters. 
Previous versions of tar will restore special files as empty 
regular files, and may return "cannot create" messages when 
extracting directory files. 
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NAME 

tbl - format tables for nroff or troff 

SYNOPSIS 

tbl [ files ] ... 

DESCRIPTION 

Tbl is a preprocessor for formatting tables for nroff or 
trof f (1) . The input files are copied to the standard out- 
put, except for lines between .TS and .TE command lines, 
which are assumed to describe tables and reformatted. 
Details are given in the reference manual. 

As an example, letting \t represent a tab (which should be 
typed as a genuine tab) the input 

.TS 

CSS 

C C s 

C c c 

Inn. 

Household Population 

TownXtHouseholds 

\tNumber\tSize 

Bedminster\t789\t3 .26 

Bernards Twp.\t3087\t3.74 

Bernardsville\t2018\t3.30 

Bound Brook\t3425\t3.04 

Branchburg\tl644\t3 . 49 

Bridgewater\t7897\t3.81 

Far Hills\t240\t3.19 

.TE 

yields 

Household Population 



Town 


Households 




Number 


Size 


Bedminster 


789 


3.26 


Bernards Twp. 


3087 


3.74 


Bernardsville 


2018 


3.30 


Bound Brook 


3425 


3.04 


Branchburg 


1644 


3.49 


Bridgewater 


7897 


3.81 


Far Hills 


240 


3.19 


> arguments are 


given. 


tbl rea 



the standard input, so 

it may be used as a filter. When it is used with eqn or 
neqn the tbl command should be first, to minimize the volume 
of data passed through pipes. 
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SEE ALSO 

troff(l), eqn(l) 
M. E. Lesk, TBL. 
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NAME 

tc - phototypesetter simulator 

SYNOPSIS 

tc [ -t ] [ -sN ] [ -pL ] [ file ] 

DESCRIPTION 

Tc interprets its input (standard input default) as device 
codes for a Graphic Systems phototypesetter (cat). The 
standard output of tc is intended for a Tektronix 4015 (a 
4014 teminal with ASCII and APL character sets). The six- 
teen typesetter sizes are mapped into the 4014 's four sizes; 
the entire TROFF character set is drawn using the 4014 's 
character generator, using overstruck combinations where 
necessary. Typical usage: 

troff -t file I tc 

At the end of each page tc waits for a newline (empty line) 
from the keyboard before continuing on to the next page. In 
this wait state, the command e will suppress the screen 
erase before the next page; sN will cause the next N pages 
to be skipped; and !line will send line to the shell. 

The command line options are: 

-t Don't wait between pages; for directing output into a 
file. 

-sN Skip the first N pages. 

-pL Set page length to L. L may include the scale factors 
p (points), i (inches), c (centimeters), and P (picas); 
default is picas. 

'-1 w' 

Multiply the default aspect ratio, 1.5, of a displayed 
page by 1/w. 

SEE ALSO 

troff(l), plot(l) 

RESTRICTIONS 

Font distinctions are lost. 

The aspect ratio option is unbelievable. 
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NAME 

ted - interactive /etc/ttys file editor 

SYNOPSIS 
ted 

DESCRIPTION 

Ted allows modification of the /etc/ttys file without the 
use of an editor. Ted insures that only valid user devices 
are created, removed, or otherwise modified by checking that 
a valid device name exists in /dev for each transaction. 

There are a variety of commands available once ted is 
invoked. Terminals may be enabled and disabled using the 
'modify' command. New entries are created using the 
'create' command, entries are removed with the 'remove' com- 
mand. General ted information is available at the main menu 
by entering 'help ted'. Additional help while using ted is 
available with the 'help' command. 

Ted maintains an internal list of the changes made to the 
/etc/ttys file. Initially this list is a duplicate of the 
/etc/ttys file. The list is updated following each newly 
entered transaction. The list may be examined at any time 
using the 'print' command. The original /etc/ttys file com- 
plete with all of the current modifications is printed. The 
'print' command lists the major and minor device numbers 
along with the name and mode of each terminal. 

Changes are not actually written to the /etc/ttys file per- 
manently until the user executes the 'write' command. The 
proposed changes are printed whereupon the user has the 
option of writing over the existing /etc/ttys file, or dis- 
carding the changes and starting over. 

It is recommended that ted be run in single-user mode to 
avoid inadvertently disabling any active user terminals. 

In multi-user mode ted may only be run by the superuser. 

FILES 

/etc/ttys, /etc/gettytab, /dev/tty? 
/tmp/TED.EDIT_LOCK 

SEE ALSO 

getty(8), init(8), gettytab(5), ttys{5) 
ULTRIX-11 System Management Guide, Section 4.7 
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NAME 

tee - pipe fitting 

SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

Tee transcribes the standard input to the standard output 
and makes copies in the files . Option -i ignores interrupts; 
option -a causes the output to be appended to the file s 
rather than overwriting them. 
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NAME 

test - condition command 

SYNOPSIS 

test expr 

DESCRIPTION 

test evaluates the expression expr , and if its value is true 
then returns zero exit status; otherwise, a non zero exit 
status is returned, test returns a non zero exit if there 
are no argxaments. 

The following primitives are used to construct expr . 

-r file true if the file exists and is readable. 

-w file true if the file exists and is writable. 

-f file true if the file exists and is not a directory. 

-d file true if the file exists and is a directory. 

-s file true if the file exists and has a size greater than 
zero. 

-t [ fildes ] 

true if the open file whose file descriptor number 
is fildes (1 by default) is associated with a ter- 
minal device. 

-z si true if the length of string si is zero. 

-n si true if the length of the string s]^ is nonzero. 

si = s2 true if the strings si and s2^ are equal. 

si != s2 true if the strings sjL and s^ are not equal. 

si true if si is not the null string. 

nl -eq n2 

true if the integers nl and n2 are algebraically 
equal. Any of the comparisons -ne, -gt, -ge, -It, 
or -le may be used in place of -eq. 

These primaries may be combined with the following opera- 
tors: 

! unary negation operator 

-a binary and operator 
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-o binary or operator 

( expr ) 

parentheses for grouping. 

-a has higher precedence than -o. Notice that all the opera- 
tors and flags are separate arguments to test . Notice also 
that parentheses are meaningful to the Shell and must be 
escaped. 

SEE ALSO 

sh(l), find(l) 
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NAME 

time - time a command 

SYNOPSIS 

time command 

DESCRIPTION 

The given command is executed; after it is complete, time 
prints the elapsed time during the command, the time spent 
in the system, and the time spent in execution of the com- 
mand. Times are reported in seconds. 

The execution time can depend on what kind of memory the 
program happens to land in; the user time in MOS is often 
half what it is in core. 

The times are printed on the diagnostic output stream. 

RESTRICTIONS 

Elapsed time is accurate to the second, while the CPU times 
are measured to the 60th second. Thus the sxim of the CPU 
times can be up to a second larger than the elapsed time. 
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NAME 



tip, cu - connect to a remote system 



SYNOPSIS 

tip [ -V ] [ - speed ] system-name 
tip [ -V ] [ - speed ] phone-nxomber 
cu phone-number [ -t ] [ -s speed ] [ 
[ -# ] 



-a acu ] [ -1 line ] 



DESCRIPTION 

Tip and cu establish a full-duplex connection to another 
machine, giving the appearance of being logged in directly 
on the remote cpu. It goes without saying that you must 
have a login on the machine (or equivalent) to which you 
wish to connect. The preferred interface is tip . The cu 
interface is included for those people attached to the 'call 
UNIX' command of version 7. This manual page describes only 
tip . 

Typed characters are normally transmitted directly to the 
remote machine (which does the echoing as well). A tilde 
('~') appearing as the first character of a line is an 
escape signal; the following are recognized: 



^D 



Drop the connection and exit (you may still be 
logged in on the remote machine). 



~c 



~i 



[ name ] 



Change directory to name (no argument implies 
change to your home directory). 

Escape to a shell (exiting the shell will return 
you to tip) . 



Copy file from local to remote. Tip prompts 
the name of a local file to transmit. 



for 



~< 



Copy file from remote to local. Tip prompts first 
for the name of the file to be sent, then for a 
command to be executed on the remote machine. 

-p from [ to ] 

Send a file to a remote UNIX host. The put com- 
mand causes the remote UNIX system to run the com- 
mand string 'cat > 'to' ', while tip sends it the 
'from' file. If the 'to' file isn't specified the 
'from' file name is used. This command is actu- 
ally a UNIX specific version of the '~>' command. 

-t from [ to ] 

Take a file from a remote UNIX host. As in the put 
command the 'to' file defaults to the 'from' file 
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name if it isn't specified. The remote host exe- 
cutes the command string 'cat •from';echo '^A ' to 
send the file to tip . 

~| Pipe the output from a remote command to a local 
UNIX process. The command string sent to the 
local UNIX system is processed by the shell, 

~# Send a BREAK to the remote system. For systems 
which don't support the necessary ioctl call the 
break is simulated by a sequence of line speed 
changes and DEL characters. 

~s Set a variable (see the discussion below) . 

-'^Z Stop tip (only available with job control). 

~? Get a summary of the tilde escapes 

Tip uses the file /etc/remote to find how to reach a partic- 
ular system and to find out how it should operate while 
talking to the system; refer to remote (5) for a full 
description. Each system has a default baud rate with which 
to establish a connection. If this value is not suitable, 
the baud rate to be used may be specified on the command 
line, e.g. 'tip -300 mds'. 

When tip establishes a connection it sends out a connection 
message to the remote system; the default value, if any, is 
defined in /etc/remote. 

When tip prompts for an argument (e.g. during setup of a 
file transfer) the line typed may be edited with the stan- 
dard erase and kill characters. A null line in response to 
a prompt, or an interrupt, will abort the dialogue and 
return you to the remote machine. 

Tip guards against multiple users connecting to a remote 
system by opening modems and terminal lines with exclusive 
access, and by honoring the locking protocol used by 
uucp (lC) . 

During file transfers tip provides a running count of the 
number of lines transferred. When using the ~> and ~< com- 
mands, the 'eofread' and 'eofwrite' variables are used to 
recognize end-of-file when reading, and specify end-of-file 
when writing (see below). File transfers normally depend on 
tandem mode for flow control. If the remote system does not 
support tandem mode, 'echocheck' may be set to indicate tip 
should synchronize with the remote system on the echo of 
each transmitted character. 
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When tj£ must dial a phone number to connect to a system it 
will print various messages indicating its actions. Tip 
supports the DEC DN-11 and Racal-Vadic 831 auto-call-uniti^ 
the DEC DF02 and DF03, Ventel 212+ , Racal-Vadic 3451, and 
Bizcomp 1031 and 1032 integral call unit/modems. 

VARIABLES 

Tip maintains a set of variables which control its opera- 
tion. Some of these variable are read-only to normal users 
(root is allowed to change anything of interest). Variables 
may be displayed and set through the 's' escape. The syntax 
for variables is patterned after vi(l) and Mail (l). Supply- 
ing 'all' as an argument to the set command displays all 
variables readable by the user. Alternatively, the user may 
request display of a particular variable by attaching a '?' 
to the end. For example 'escape?' displays the current 
escape character. 

Variables are numeric, string, character, or boolean values 
Boolean variables are set merely by specifying their name; 
they may be reset by prepending a ' ! ' to the name. Other 
variable types are set by concatenating an '=' and the 
value. The entire assignment must not have any blanks in 
it. A single set command may be used to interrogate as well 
as set a number of variables. Variables may be initialized 
at run time by placing set commands (without the '~s' prefix 
in a file . tiprc in one's home directory). The -v option 
causes ti^ to display the sets as they are made. Certain 
common variables have abbreviations. The following is a list 
of common variables, their abbreviations, and their default 
values. 

beautify 

(bool) Discard unprintable characters when a session is 
being scripted; abbreviated be . 

baudrate 

(num) The baud rate at which the connection was esta- 
blished; abbreviated ba. 

dialtimeout 

(num) When dialing a phone number, the time (in 
seconds) to wait for a connection to be established* 
abbreviated dial . ' 

echocheck 

(bool) Synchronize with the remote host during file 
transfer by waiting for the echo of the last character 
transmitted; default is off. 
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eof read 

(str) The set of characters which signify and end-of- 
transmission during a ~< file transfer command; abbre- 
viated eofr . 

eofwrite 

(str) The string sent to indicate end-of-transmission 
during a ~> file transfer command; abbreviated eofw. 

eol 

(str) The set of characters which indicate an end-of- 
line. Tip will recognize escape characters only after 
an end-of-line. 

escape 

(char) The command prefix (escape) character; abbrevi- 
ated es; default value is '~'. 

exceptions 

(str) The set of characters which should not be dis- 
carded due to the beaut ificat ion switch; abbreviated 
ex; default value is '\t\n\f\b'. 

force 

(char) The character used to force literal data 
transmission; abbreviated fo; default value is "^P' . 

f ramesize 

(num) The amount of data (in bytes) to buffer between 
file system writes when receiving files; abbreviated 



host 



fr. 



(str) The name of the host to which you are connected; 
abbreviated ho. 



prompt 

(char) The character which indicates and end-of-line on 
the remote host; abbreviated £r; default value is '\n'. 
This value is used to synchronize during data 
transfers. The count of lines transferred during a 
file transfer command is based on recipt of this char- 
acter. 

raise 

(bool) Upper case mapping mode; abbreviated ra; default 
value is off. When this mode is enabled, all lower 
case letters will be mapped to upper case by tip for 
transmission to the remote machine. 
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raisechar 

(char) The input character used to toggle upper case 
mapping mode; abbreviated re; default value 



IS 



^A' 



record 

(str) The name of the file 
recorded; abbreviated 
'tip. record' . 



in which a session script 



rec; 



default value 



IS 

is 



script 

(bool) Session scripting mode; abbreviated sc; default 
^s off. When script is true , tip will record every- 
thing transmitted by the remote machine in the script 
record file specified in record . If the beautify 
switch is on, only printable ASCII characters wTTT be 
included in the script file (those characters betwee 
040 and 0177). The variable exceptions is used to 
indicate characters which are an exception to the nor- 
mal beautif ication rules. 

tabexpand 

(bool) Expand tabs to spaces during file transfers; 
abbreviated tab ; default value is false . Each tab is 
expanded to 8 spaces. 

verbose 

(bool) Verbose mode; abbreviated verb ; default is true . 
When verbose mode is enabled, tip prints messages while 
dialing, shows the current number of lines transferred 
during a file transfer operations, and more. 



SHELL 



(str) The name of the shell to use for the ~! command; 
default value is '/bin/sh', or taken from the environ- 
ment. 



HOME 



FILES 



(str) The home directory to use for the ~c 
default value is taken from the environment. 



command; 



/etc/remote 

/etc/phones 

$ {REMOTE} 

$ {PHONES} 

~/.tiprc 

/usr/spool/uucp/LCK. .* 



global system descriptions 
global phone number data base 
private system descriptions 
private phone numbers 
initialization file, 
lock file to avoid conflicts with 



UUCP 
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DIAGNOSTICS 

Diagnostics are, hopefully, self explanatory. 

SEE ALSO 

remote(5), phones(5) 

RESTRICTIONS 

The full set of variables is undocumented and should, prob- 
ably, be paired down. 
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NAME 

tk - paginator for the Tektronix 4014 

SYNOPSIS 

tk [ -t ] [ -N ] [ -pL ] [ file ] 

DESCRIPTION 

The output of tk is intended for a Tektronix 4014 terminal. 
Tk arranges for 66 lines to fit on the screen, divides the 
screen into N columns, and contributes an eight space page 
offset in the (default) single-column case. Tabs, spaces 
and backspaces are collected and plotted when necessary! 
Teletype Model 37 half- and reverse-line sequences are 
interpreted and plotted. At the end of each page tk waits 
for a newline (empty line) from the keyboard before~continu- 
ing on to the next page. In this wait state, the command 
! command will send the command to the shell. 

The command line options are: 

-t Don't wait between pages; for directing output into a 
file. 

-N Divide the screen into N columns and wait after the 
last column. 

-pL Set page length to L lines. 

SEE ALSO 
pr(l) 
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NAME 

touch - update date last modified of a file 

SYNOPSIS 

touch [ -c ] file ... 

DESCRIPTION 

Touch attempts to set the modified date of each file . This 
IS done by reading a character from the file and writing it 
back. 

If a file does not exist, an attempt will be made to create 
it unless the -c option is specified. 
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NAME 

tp - manipulate tape archive 

SYNOPSIS 

tp [ key ] [ name ... ] 

DESCRIPTION 

Tp saves and restores files on DECtape or magtape. Its 
actions are controlled by the key argument. The key is a 
string of characters containing at most one function letter 
and possibly one or more function modifiers. Other argu- 
ments to the command are file or directory names specifying 
which files are to be dumped, restored, or listed. In all 
cases, appearance of a directory name refers to the files 
and (recursively) subdirectories of that directory. 

The function portion of the key is specified by one of the 
following letters: 

r The named files are written on the tape. If files 
with the same names already exist, they are 
replaced. 'Same' is determined by string com- 
parison, so './abc' can never be the same as 
'/usr/dmr/abc' even if '/usr/dmr' is the current 
directory. If no file argument is given, '.' is the 
default. 

u updates the tape, u is like r, but a file is 
replaced only if its modification date is later than 
the date stored on the tape; that is to say, if it 
has changed since it was dumped, u is the default 
command if none is given. 

d deletes the named files from the tape. At least one 
name argument must be given. This function is not 
permitted on magtapes. 

X extracts the named files from the tape to the file 
system. The owner and mode are restored. If no 
file argument is given, the entire contents of the 
tape are extracted. 

t lists the names of the specified files. If no file 
argument is given, the entire contents of the tape 
is listed. 

The following characters may be used in addition to the 
letter which selects the function desired. 

h Specifies 1600 BPI magtape as opposed to DECtape. 

m Specifies 800 BPI magtape as opposed to DECtape. 
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0, . . . ,7 



This modifier 
is mounted. 



selects the drive 
For DECtape, x 



magtape '0' is the default. 



on which the tape 
is default; for 



Normally tp does its work silently. The v (ver- 
bose) option causes it to type the name of each 
file it treats preceded by the function letter. 
With the t function, v gives more information 
about the tape entries than just the name. 



means a fresh dump is 
directory is cleared 
only with r and u. This 
magtape since it is 
overwrite magtape. 



being created; the tape 

before beginning. Usable 

option is assumed with 

impossible to selectively 



Errors reading and writing the tape are noted, but 
no action is taken. Normally, errors cause a 
return to the command level. 

Use the first named file, rather than a tape, as 
the archive. This option is known to work only 
with X. 



w 



causes tp to pause before treating each file, type 
the indicative letter and the file name (as with 
v) and await the user's response. Response y 



means 'yes', so the file is 
response means 'no', and the file 
part in whatever is being done, 
'exit'; the t£ command terminates 
the X function, files previously 
been extracted already. With r, 
change has been made to the tape. 



treated. Null 

does not take 

Response x means 

immediately. In 

asked about have 

u, and d no 



FILES 

/dev/tap? 

/dev/mt? 

/dev/ht? 

SEE ALSO 

ar(l), tar(l) 



DIAGNOSTICS 

Several; the non-obvious one is 'Phase error', which means 
the file changed after it was selected for dumping but 
before it was dumped. 
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RESTRICTIONS 

A single file with several links to it is treated like 
several files. 

Binary-coded control information makes magnetic tapes writ- 
ten by t£ difficult to carry to other machines; tar(l) 
avoids the problem. 
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NAME 

tr - translate characters 

SYNOPSIS 

tr [ -cds ] [ stringl [ string2 ] ] 

DESCRIPTION 

Tr copies the standard input to the standard output with 
substitution or deletion of selected characters. Input 
characters found in stringl are mapped into the correspond- 
ing characters of string2 . When string2 is short it is pad- 
ded to the length of stringl by duplicating its last cnarac- 
ter. Any combination of the options -cds may be used: -c 
complements the set of characters in stringl with respect to 
the universe of characters whose ASCII codes are 01 through 
0377 octal; -d deletes all input characters in stringl ; -s 
squeezes all strings of repeated output characters that are 
in string2 to single characters. 

In either string the notation a-b means a range of charac- 
ters from a to b in increasing ASCII order. The character 
•\' followed by 1, 2 or 3 octal digits stands for the char- 
acter whose ASCII code is given by those digits. A '\' fol- 
lowed by any other character stands for that character. 

The following example creates a list of all the words in 
'filel' one per line in 'file2', where a word is taken to be 
a maximal string of alphabetics. The second string is 
quoted to protect '\' from the Shell. 012 is the ASCII code 
for newline. 

tr -cs A-Za-z '\012' <filel >file2 

SEE ALSO 

ed(l), ascii(7) 

RESTRICTIONS 

Won't handle ASCII NUL in stringl or string2 ; always deletes 
NUL from input. 
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NAME 



troff, nroff - text formatting and typesetting 



SYNOPSIS 

troff [ option ] ... [ file ] ... 

nroff [ option ] — [ file ] ... 

DESCRIPTION 

Troff formats text in the named files for printing on a 
Graphic Systems C/A/T phototypesetter; nroff for 
typewriter-like devices. Their capabilities are described 
in the Nroff /Troff user's manual. 



If no file argument is present, the standard input is read. 
An argument consisting of a single minus (-) is taken to be 
a file name corresponding to the standard input. The 
options, which may appear in any order so long as they 
appear before the files, are: 

-o list Print only pages whose page numbers appear in the 
comma-separated list of numbers and ranges. A range 
N-M means pages N through M; an initial -N means from 
the beginning to page N; and a final N- means from N 
to the end. 

-nN Number first generated page N. 

-sN Stop every N pages. Nroff will halt prior to every N 
pages (default N=l) to allow paper loading or chang- 
ing, and will resume upon receipt of a newline. 
Troff will stop the phototypesetter every N pages, 
produce a trailer to allow changing cassettes, and 
resume when the typesetter's start button is pressed. 

-m name Prepend the macro file /usr/1 ib/tmac/tmac . name to the 
input files . 



■raN 



Set register a (one-character) to N. 



-i Read standard input after the input files are 
exhausted. 



-q Invoke the simultaneous input-output mode of the rd 
request. 

Nroff only 

-T name Prepare output for specified terminal. Known names 
are 37 for the (default) Teletype Corporation Model 
37 terminal, tn300 for the GE TermiNet 300 (or any 
terminal without half-line capability), 300S for the 
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NAME 

tss - list TTY structure assignments 

SYNOPSIS 

/etc/tss 

DESCRIPTION 

Each port on any communications interface is assigned a TTY 

structure from the pool of TTY structures. The tss command 

lists the current TTY structure assignments. 

The tss command can be useful when debugging a user written 
communications device driver. 
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DASI-300S, 300 for the DASI-300, and 450 for the 
DASI-450 (Diablo Hyterm) . 

-e Produce equally-spaced words in adjusted lines, using 
full terminal resolution. 

-h Use output tabs during horizontal spacing to speed 
output and reduce output character count. Tab set- 
tings are assumed to be every 8 nominal character 
widths. 

Trof f only 

-t Direct output to the standard output instead of the 
phototypesetter . 

-f Refrain from feeding out paper and stopping photo- 
typesetter at the end of the run. 

-w Wait until phototypesetter is available, if currently 
busy. 

-b Report whether the phototypesetter is busy or avail- 
able. No text processing is done. 

-a Send a printable ASCII approximation of the results 
to the standard output. 

-pN Print all characters in point size N while retaining 
all prescribed spacings and motions, to reduce photo- 
typesetter elapsed time. 

-g Prepare output for a GCOS phototypesetter and direct 
it to the standard output (see gcat (l) ) . 

If the file / usr / adm / tracct is writable, trof f keeps photo- 
typesetter accounting records there. The integrity of that 
file may be secured by making trof f a 'set user-id' program. 

FILES 

/usr/lib/suf tab suffix hyphenation tables 

/tmp/ta* temporary file 
/usr/lib/tmac/tmac* standard macro files 

/usr/lib/term/* terminal driving tables for nrof f 

/usr/lib/font/* font width tables for trof f 

/dev/cat phototypesetter 

/usr/adm/tracct accounting statistics for /dev/cat 
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SEE ALSO 

J. F. Ossanna, Nrof f / Troff user 's ma nual 
B. W. Kernighan, 
eqn(l), tbl(l) 
col(l), tkd) (nroff 
tc(l), gcatd) 



A T ROFF Tutorial 

^__^ only) 
( troff only) 
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NAME 

true, false - provide truth values 

SYNOPSIS 
true 

false 

DESCRIPTION 

True does nothing, successfully. False does nothing, unsuc- 
cessfully. They are typically used in input to sh(l) such 
as: 

while true 
do 

conunand 
done 

SEE ALSO 
sh{l) 

DIAGNOSTICS 

True has exit status zero, false nonzero. 
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NAME 



tset, reset - set terminal modes 



SYNOPSIS 

tset [ options ] [ -m [ ident] [test baudrate] :type ] 
type ] 



... [ 



reset . . . 



DESCRIPTION 

Tset sets up your terminal when you first log in to a UNIX 
system. It does terminal dependent processing such as set- 
ting erase and kill characters, setting or resetting delays, 
and the like. It first determines the type of terminal 
involved, and then does necessary initializations and mode 
settings. The type of terminal attached to each UNIX port 
is specified in the / etc /tt ytype database. Type names for 
terminals may be found in the / etc / termcap database. If a 
port is not wired permanently to a specific terminal (not 



hardwired) it will 
ier such as dialup . 



be given an appropriate generic identif- 



In the case where no arguments are specified, tset simply 
reads the terminal type out of the environment variable TERM 
and reinitializes the terminal. The rest of this manual 
concerns itself with mode and environment initialization, 
typically done once at login, and options used at initiali- 
zation time to determine the terminal type and set up termi- 
nal modes. 

When used in a startup script ( . profile for sh(l) users or 
. login for csh(l) users) it is desirable to give information 
about the type of terminal you will usually use on ports 
which are not hardwired. These ports are identified in 
/ etc / ttytype as dialup or plugboard or arpanet , etc. To 
specify what terminal type you usually use on these ports, 
the -m (map) option flag is followed by the appropriate port 
type identifier, an optional baud rate specification, and 
the terminal type. (The effect is to 'map' from some condi- 
tions to a terminal type, that is, to tell tset 'If I'm on 
this kind of port, guess that I'm on that kind of termi- 
nal'.) If more than one mapping is specified, the first 
applicable mapping prevails. A missing port type identifier 
matches all identifiers. Any of the alternate generic names 
given in termcap may be used for the identifier. 



A baudrate is specified as with stty (l) , and is compared 
with the speed of the diagnostic output (which should be the 

The baud rate test may be any combina- 
<, and !; & means 'at' and ! inverts the 

To avoid problems with metacharacters. 



control terminal) 
tion of: >, (i , 
sense of the test 
it is best to 



place the entire argument to -m within 
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characters; users of csh (l) must also put a '\' before any 
' ! • used here. 

Thus 

tset -m 'dialup>300:adm3a' -m dialup:dw2 -iti ' plugboard: ?adm3a' 

causes the terminal type to be set to an admSa if the port 
in use is a dialup at a speed greater than 300 baud; to a 
dv2 if the port is (otherwise) a dialup (i.e. at 300 baud or 
less). If the type finally determined by tset begins with a 
question mark, the user is asked if s/he really wants that 
type. A null response means to use that type; otherwise, 
another type can be entered which will be used instead. 
Thus, in the above case, the user will be queried on a plug- 
board port as to whether they are actually using an adm3a . 

If no mapping applies and a final type option, not preceded 
by a -m, is given on the command line then that type is 
used; otherwise the identifier found in the / etc / ttytype 
database will be taken to be the terminal type. This should 
always be the case for hardwired ports. 

It is usually desirable to return the terminal type, as 
finally determined by tset, and information about the 
terminal's capabilities to a shell's environment. This can 
be done using the -s option; using the Bourne shell, sh(l): 

eval "tset -s options . . . " 
or using the C shell, csh(l): 

set noglob; eval "tset -s options . . . " 

If you have an old csh with no eval command, do the follow- 
ing: 

tset -s options > /tmp/tset$$ ; source /tmp/tset$$ ; rm /tmp/tset$$ 

In either csh case, you should probably make an alias in 
your .cshrc: 

alias tset 'set noglob; eval "tset -s *"' 

or 

alias tset 'tset -s * > /tmp/tset$$ ; source /tmp/tset$$ ; 
rm /tmp/tset$$' 
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Either of these aliases allow the command 

tset 2621 
to be invoked at any time from your login csh. Note to 
Bourne Shell users: It is not possible to get this aliasing 
effect with a shell script, because shell scripts cannot set 
the environment of their parent. (If a process could set 
its parent's environment, none of this nonsense would be 
necessary in the first place.) 

These commands cause tset to generate as output a sequence 
of shell commands which place the variables TERM and TERMCAP 
in the environment; see environ (5) . 

Once the terminal type is known, tset engages in terminal 
driver mode setting. This normally involves sending an ini- 
tialization sequence to the terminal, setting the single 
character erase (and optionally the line-kill (full line 
erase)) characters, and setting special character delays. 
Tab and newline expansion are turned off during transmission 
of the terminal initialization sequence. 

On terminals that can backspace but not overstrike (such as 
a CRT), and when the erase character is the default erase 
character ('#' on standard systems), the erase character is 
changed to DELETE. 

The options are: 

-ec set the erase character to be the named character c on 
all terminals, the default being the backspace charac- 
ter on the terminal, in this case DELETE. The charac- 
ter c can either be typed directly, or entered using 
the hat notation used here. 

-kc is similar to -e but for the line kill character rather 
than the erase character; c defaults to ^X (for purely 
historical reasons). The kill character is left alone 
if -k is not specified. The hat notation can also be 
used for this option. 

-n On systems with the new tty driver, specifies that the 
new tty driver modes should be initialized for this 
terminal. For a CRT, the CRTERASE and CRTKILL modes 
are set only if the baud rate is 1200 or greater. See 
newtty(4) for more detail. 

-V On systems with CB/UNIX virtual terminals, normally 
tset sets up the tty driver modes and the environment 
TERMCAP variable to use the virtual terminal. The -v 
option turns off this processing, causing tset to_not 
use a virtual terminal. 
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-I suppresses transmitting terminal initialization 
strings. 

-Q suppresses printing the 'Erase set to' and 'Kill set 
to' messages. 

-S If your shell is csh , tset will output the strings to 
be assigned to TERM and TERMCAP in the environment 
rather than commands for a shell. This is mainly use- 
ful to avoid the (slow) source command with an old csh . 

If tset is invoked as reset , it will set cooked and echo 
modes, turn off cbreak and raw modes, turn on newline trans- 
lation, and restore special characters to a sensible state 
before any terminal dependent processing is done. Any spe- 
cial character that is found to be NULL or '-1' is reset to 
it's default value. 

This is most useful after a program dies leaving a terminal 
in a funny state. You may have to type '<LF>reset<LF>' to 
get it to work since <CR> may not work in this state. Often 
none of this will echo. 

EXAMPLES 

These examples all assume the Bourne shell and use the -s 
option. If you use csh, use one of the variations described 
above. Note that a typical use of tset in a .profile or 
.login will also use the -e and -k options, and often the -n 
or -Q options as well. These options have not been included 
here to keep the examples small. (NOTE: some of the exam- 
ples given here appear to take up more than one line, for 
text processing reasons. When you type in real tset com- 
mands, you must enter them entirely on one line.) 

At the moment, you are on a 2621. This is suitable for typ- 
ing by hand but not for a .profile, unless you are always on 
a 2621. 



eval 'tset -s 2621' 

You have an hl9 at home which you dial up on, but your 
office terminal is hardwired and known in /etc/ttytype. 



eval 'tset -s -m dialup:hl9' 

You have a switch which connects everything to everything, 
making it nearly impossible to key on what port you are com- 
ing in on. You use a vtlOO in your office at 9600 baud, and 
dial up to switch ports at 1200 baud from home on a 2621. 
Sometimes you use someone elses terminal at work, so you 
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want it to ask you to make sure what terminal type you have 
at high speeds, but at 1200 baud you are always on a 2621. 
Note the placement of the question mark, and the quotes to 
protect the greater than and question mark from interpreta- 
tion by the shell. 

eval ^tset -s -m ' switch>1200:?vtl00' -m ' switch<=1200:2621' ' 

All of the above entries will fall back on the terminal type 
specified in /etc/ttytype if none of the conditions hold. 
The following entry is appropriate if you always dial up, 
always at the same baud rate, on many different kinds of 
terminals. Your most common terminal is an admSa. It 
always asks you what kind of terminal you are on, defaulting 
to adm3a. 

eval "tset -s ?adm3a' 

If the file /etc/ttytype is not properly installed and you 
want to key entirely on the baud rate, the following can be 
used: 

eval "tset -s -m ' >1200:vtl00' 2621' 

Here is a fancy example to illustrate the power of tset and 
to hopelessly confuse anyone who has made it this far. You 
dial up at 1200 baud or less on a conceptlOO, sometimes over 
switch ports and sometimes over regular dialups. You use 
various terminals at speeds higher than 1200 over switch 
ports, most often the terminal in your office, which is a 
vtlOO. However, sometimes you log in from the university 
you used to go to, over the ARPANET; in this case you are on 
an ALTO emulating a dm250G. You also often log in on vari- 
ous hardwired ports, such as the console, all of which are 
properly entered in /etc/ttytype. You want your erase char- 
acter set to control H, your kill character set to control 
U, and don't want tset to print the "Erase set to Backspace, 
Kill set to Control U" message. 

eval 'tset -e -k'^U -Q -s -m ' switch<=1200:conceptl00' -m ' switch: ?vtl00 ' 
-m dialup:conceptl00 -m arpanet:dm2500' 

FILES 

/etc/ttytype port name to terminal type mapping data- 
base 
/etc/termcap terminal capability database 

SEE ALSO 

csh(l), sh(l), stty(l), environ(5), termcap(5), ttytype(5) 
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NAME 

tsort - topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list 
of items consistent with a partial ordering of items men- 
tioned in the input file . If no file is specified, the 
standard input is understood. 

The input consists of pairs of items (nonempty strings) 
separated by blanks. Pairs of different items indicate ord- 
ering. Pairs of identical items indicate presence, but not 
ordering. 

SEE ALSO 

lorder(l) 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input 
file. 

RESTRICTIONS 

Uses a quadratic algorithm; not worth fixing for the typical 
use of ordering a library archive file. 
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NAME 

tty - get terminal name 

SYNOPSIS 
tty 

DESCRIPTION 

Tty prints the pathname of the user's terminal. 

DIAGNOSTICS 

'not a tty' if the standard input file is not a terminal. 
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NAME 

ul - do underlining 

SYNOPSIS 

ul [ -i ] [ -t terminal ] [ name ... ] 

DESCRIPTION 

Ul reads the named files (or standard input if none are 
given) and translates occurrences of underscores to the 
sequence which indicates underlining for the terminal in 
use, as specified by the environment variable TERM. The -t 
option overrides the terminal kind specified in the environ- 
ment. The file / etc / termcap is read to determine the 
appropriate sequences for underlining. If the terminal is 
incapable of underlining, but is capable of a standout mode 
then that is used instead. If the terminal can overstrike, 
or handles underlining automatically, ul degenerates to 
cat (1) . If the terminal cannot underline, underlining is 
ignored. 

The -i option causes ul to indicate underlining onto by a 

separate line containing appropriate dashes '-'; this is 

useful when you want to look at the underlining which is 
present in an nrof f output stream on a crt-terminal. 

SEE ALSO 

man(l), nroff(l), colcrt(l) 

AUTHOR 

Mark Horton wrote ul. The -i option was originally an 
option of the editor ex(l), then an iul command. 

RESTRICTIONS 

Nrof f usually outputs a series of backspaces and underlines 
intermixed with the text to indicate underlining. No 
attempt is made to optimize the backward motion. 



UNGET(l) 



UNGET(l) 



NAME 



unget - undo a previous get of an SCCS file 



SYNOPSIS 

unget [-rSID] [-s] [-n] files 



-e done prior to creating 
a directory is named, unget 



DESCRIPTION 

Unget undoes the effect of a get 
the intended new delta. If 

behaves as though each file in the directory were specified 
as a named file, except that non-SCCS files and unreadable 
files are silently ignored. If a name of - is given, the 
standard input is read with each line being taken as the 
name of an SCCS file to be processed. Keyletter arguments 
apply independently to each named file. 



-rSID 



Uniquely identifies which delta is no 
longer intended. (This would have been 
specified by get as the 'new delta'). The 
use of this keyletter is necessary only if 
two or more outstanding get s for editing on 
the same SCCS file were done by the same 
person (login name). A diagnostic results 
if the specified SID is ambiguous, or if it 
is necessary and omitted on the command 
line. 



-s 



-n 



Suppresses the printout, on the standard 
output, of the intended delta's SID . 

Causes the retention of the gotten file 
which would normally be removed from the 
current directory. 



SEE ALSO 

delta(l), get(l), sact(l). 

DIAGNOSTICS 

Use help (l) for explanations. 
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NAME 

uniq - report repeated lines in a file 

SYNOPSIS 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the 
normal case, the second and succeeding copies of repeated 
lines are removed; the remainder is written on the output 
file. Note that repeated lines must be adjacent in order to 
be found; see sort (l) . If the -u flag is used, just the 
lines that are not repeated in the original file are output. 
The -d option specifies that one copy of just the repeated 
lines is to be written. The normal mode output is the union 
of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output 
report in default style but with each line preceded by a 
count of the number of times it occurred. 

The n arguments specify skipping an initial portion of each 
line in the comparison: 

-n The first n fields together with any blanks before 
each are ignored. A field is defined as a string of 
non-space, non-tab characters separated by tabs and 
spaces from its neighbors. 

+n The first n characters are ignored. Fields are 
skipped before characters. 

SEE ALSO 

sort (1) , comm(l) 



UNITS(l) UNITS(l) 



NAME 

units - conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Units converts quantities expressed in various standard 
scales to their equivalents in other scales. It works 
interactively in this fashion: 

You have ; inch 
You want: cm 

* 2.54000e+00 
/ 3. 93701e -01 

A quantity is specified as a multiplicative combination of 
units optionally preceded by a numeric multiplier. Powers 
are indicated by suffixed positive integers, division by the 
usual sign: 

You have : 15 pounds force/in2 
You want : atm 

* 1.02069e+00 
/ 9. 79730e -01 

Units only does multiplicative scale changes. Thus it can 
convert Kelvin to Rankine, but not Centigrade to Fahrenheit. 
Most familiar units, abbreviations, and metric prefixes are 
recognized, together with a generous leavening of exotica 
and a few constants of nature including: 

pi ratio of circumference to diameter 

c speed of light 

e charge on an electron 

g acceleration of gravity 

force same as g 

mole Avogadro's number 

water pressure head per unit height of water 

au astronomical unit 

'Pound' is a unit of mass. Compound names are run together, 

e.g. 'lightyear'. British units that differ from their US 

counterparts are prefixed thus: 'brgallon'. Currency is 
denoted 'belgiiomfranc' , 'britainpound' , ... 

For a complete list of units, 'cat /usr/lib/units' . 
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FILES 

/usr/lib/units 

RESTRICTIONS 

Don't base your financial plans on the currency conversions. 
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NAME 

usat - ULTRIX-11 System Acceptance Test 

SYNOPSIS 

usat [ help ] [ option... ] 

DESCRIPTION 

Usat tests and verifies the existence and correct operation 
of various ULTRIX-11 commands. Without an argument, usat 
lists the names of the tests which are available. 

Usat runs each specified command using a test input file. 
After executing the command, it compares the output with a 
file containing the known, correct result. Files used for 
each test are located in /usr/lib/usat/test, where 'test' is 
the command name directory. 

Multiple copies of usat may be run in the same directory 
without fear of collisions. An exception, however, is run- 
ning simultaneous yacc tests in the same directory. Because 
a common output file y.tab.c is generated, usat cannot 
guarantee consistent results in this case. 

EXAMPLE 

usat c c 

runs two copies, one after the other, of the C compiler 
test. A short C program found in /usr/lib/usat/cc generates 
a table of temperatures. The input file cc.in.c is compiled 
and executed. Its output is then compared with the known, 
correct output found in cc.sout. The .sout notation 
represents a {s)ave (out)put file. If the files fail to 
compare, the cc test fails, and a warning message is 
printed. 

FILES 

/usr/lib/usat/?, /tmp/??? 

SEE ALSO 

usep(l) 
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NAME 

users - compact list of users who are on the system 

SYNOPSIS 

users 

DESCRIPTION 

Users lists the login names of the users currently on the 
system in a compact, one-line format. 

FILES 

/etc/utmp 

SEE ALSO 

finger(l), who(l) 
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NAME 

uucp, uulog - unix to unix copy 

SYNOPSIS 

uucp [ option ] ... source-file ... destination-file 

uulog [ option ] ... 

DESCRIPTION 

Uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name 
on your machine, or may have the form 

system-name ! pathname 

where 'system-name' is taken from a list of system names 
which uucp knows about. Shell metacharacters ?*[] appearing 
in the pathname part will be expanded on the appropriate 
system. 

Pathnames may be one of 

(1) a full pathname; 

(2) a pathname preceded by ~user; where user is a user id on 
the specified system and is replaced by that user's 
login directory; 

(3) anything else is prefixed by the current directory. 

If the result is an erroneous pathname for the remote system 
the copy will fail. If the destination-file is a directory, 
the last part of the source-file name is used. 

Uucp preserves execute permissions across the transmission 
and gives 0666 read and write permissions (see chmod (2) ) . 

The following options are interpreted by uucp . 

-d Make all necessary directories for the file copy. 

-c Use the source file when copying out rather than copy- 
ing the file to the spool directory. 

-m Send mail to the requester when the copy is complete. 

Uulog maintains a summary log of uucp and uux(l) transac- 
tions in the file '/usr/spool/uucp/LOGFILE' by gathering 
information from partial log files named 
•/usr/spool/uucp/LOG.*.?' . It removes the partial log 

files. 
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The options cause uulog to print logging information: 



Print information about work involving system sys . 

-u user 

Print information about work done for the specified 
user . 

FILES 

/usr/spool/uucp - spool directory 
/usr/lib/uucp/* - other data and program files 

SEE ALSO 

uux ( 1 ) , ma i 1 { 1 ) 

D. A. Nowitz, Uucp Implementat ion Description 

WARNING 

The domain of remotely accessible files can (and for obvious 
security reasons, usually should) be severely restricted. 
You will very likely not be able to fetch files by pathname; 
ask a responsible person on the remote system to send them 
to you. For the same reasons you will probably not be able 
to send files to arbitrary pathnames. 

RESTRICTIONS 

All files received by uucp will be owned by uucp. 
The -m option will only work sending files or receiving a 
single file. (Receiving multiple files specified by special 
shell characters ?*[] will not activate the -m option.) 
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NAME 

uux - Unix to unix command execution 

SYNOPSIS 

uux [ - ] command-string 

DESCRIPTION 

Uux will gather or more files from various systems, exe- 
cute a command on a specified system and send standard out- 
put to a file on a specified system. 

The command-string is made up of one or more arguments that 

look like a shell command line, except that the command and 

file names may be prefixed by system-name!. A null system- 
name is interpreted as the local system. 

File names may be one of 

(1) a full pathname; 

(2) a pathname preceded by ~ xxx ; where xxx is a userid 
on the specified system and is replaced by that user's 
login directory; 

(3) anything else is prefixed by the current directory. 

The '-' option will cause the standard input to the uux com- 
mand to be the standard input to the command- string. 

For example, the command 

uux "Idiff usg!/usr/dan/fl pwba!/a4/dan/f 1 > "fi.diff" 

will get the fl files from the usg and pwba machines, exe- 
cute a dif f command and put the results in fi.diff in the 
local directory. 

Any special shell characters such as <>; I should be quoted 
either by quoting the entire command-string, or quoting the 
special characters as individual arguments. 

FILES 

/usr/uucp/spool - spool directory 
/usr/uucp/* - other data and programs 

SEE ALSO 

uucp (1 ) 

D. A. Nowitz, Uucp implementation description 

WARNING 

An installation may, and for security reasons generally 
will, limit the list of commands executable on behalf of an 
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incoming request from uux. Typically, a restricted site will 
permit little other than the receipt of mail via uux . 

RESTRICTIONS 

Only the first command of a shell pipeline may have a 

system-name!. All other commands are executed on the system 

of the first command. 

The use of the shell metacharacter * will probably not do 

what you want it to do. 

The shell tokens « and » are not implemented. 

There is no notification of denial of execution on the 

remote machine. 
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NAME 



val - validate SCCS file 



SYNOPSIS 
val 
val 



[-s] [-rSID] [-mname] [-ytype] files 



DESCRIPTION 

Val determines if the specified file 

the characteristics specified by 

Arguments to val may appear in any 

consist of keyletter arguments, which begin with 

named files. 



is an SCCS file meeting 

the optional argument list. 

order. The arguments 

a - , and 



Val has a special argument, -, which causes reading of the 
standard input until an end-of-file condition is detected. 
Each line read is independently processed as if it were a 
command line argument list. 

Val generates diagnostic messages on the standard output for 
each command line and file processed and also returns a sin- 
gle 8-bit code upon exit as described below. 

The keyletter arguments are defined as follows. The effects 
of any keyletter argument apply independently to each named 
file on the command line. 



-rSID 



-mname 



-y type 



The presence of this argument silences 
the diagnostic message normally gen- 
erated on the standard output for any 
error that is detected while processing 
each named file on a given command line. 



SID 



(SCCS 



The argument value _ 

IDentif ication String) is an SCCS delta 
number. A check is made to determine if 
the SID is ambiguous (e. g., rl is ambi- 
guous because it physically does not 
exist but implies 1.1, 1.2, etc. which 
may exist) or invalid (e. g., rl.O or 
rl.1.0 are invalid because neither case 
can exist as a valid delta number). If 
the SID is valid and not ambiguous, a 
check IS made to determine if it actu- 
ally exists. 

The argument value name is compared with 
the SCCS %M% keyword in file . 

The argument value type is compared with 
the SCCS %Y% keywordin file. 
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The 8-bit code returned by val is a disjunction of the pos- 
sible errors, i. e., can be interpreted as a bit string 
where {moving from left to right) set bits are interpreted 
as follows: 

bit = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = can't open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %Y%, -y mismatch; 

bit 7 =? %M%, -m mismatch; 

Note that val can process two or more files on a given com- 
mand line and in turn can process multiple command lines 
(when reading the standard input). In these cases an aggre- 
gate code is returned - a logical OR of the codes generated 
for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), prs{l). 

DIAGNOSTICS 

Use help (l) for explanations. 

RESTRICTIONS 

Val can process up to 50 files on a single command line. 
Any number above 50 will produce a core dump. 
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NAME 



vc - version control 



SYNOPSIS 

vc [-a] [-t] [-cchar] [-s] [keyword=value 



keyword=value] 



DESCRIPTION 

The vc conunand copies lines from the standard input to the 
standard output under control of its arguments and control 
statements encountered in the standard input. In the pro- 
cess of performing the copy operation, user declared key- 
words may be replaced by their string value when they appear 
in plain text and/or control statements. 

The copying of lines from the standard input to the standard 
output is conditional, based on tests {in control state- 
ments) of keyword values specified in control statements or 
as vc command arguments. 

A control statement is a single line beginning with a con- 
trol character, except as modified by the -t keyletter (see 
below) . The default control character is colon ( : ) , except 
as modified by the -c keyletter (see below). Input lines 
beginning with a backslash (\) followed by a control charac- 
ter are not control lines and are copied to the standard 
output with the backslash removed. Lines beginning with a 
backslash followed by a non-control character are copied in 
their entirety. 

A keyword is composed of 9 or less alphanumerics; the first 
must be alphabetic. A value is any ASCII string that can be 
created with ed{l); a numeric value is an unsigned string of 
digits. Keyword values may not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword 
surrounded by control characters is encountered on a version 
control statement. The -a keyletter (see below) forces 
replacement of keywords in all lines of text. An uninter- 
preted control character may be included in a value by 
preceding it with \. If a literal \ is desired, then it too 
must be preceded by \. 

Keyletter arguments 



-a 



-t 



Forces replacement of keywords sur- 
rounded by control characters with their 
assigned value in all text lines and not 
just in vc statements. 

All characters from the beginning of a 
line up to and including the first tab 
character are ignored for the purpose of 
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detecting a control statement. If one 
is found, all characters up to and 
including the tab are discarded. 

-c char Specifies a control character to be used 
in place of : . 

-s Silences warning messages (not error) 

that are normally printed on the diag- 
nostic output. 

Version Control Statements 

:dcl keyword[ , ..., keyword] 

Used to declare keywords. All keywords must be 
declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement 
overrides the assignment for the corresponding keyword 
on the vc command line and all previous asg's for that 
keyword. Keywords declared, but not assigned values 
have null values. 

:if condition 



end 



Used to skip lines of the standard input. If the condi- 
tion is true all lines between the jj^ statement and the 
matching end statement are copied to the standard out- 
put. If the condition is false, all intervening lines 
are discarded, including control statements. Note that 
intervening j^ statements and matching end statements 
are recognized solely for the purpose of maintaining 
the proper if- end matching. 
The syntax of a condition is: 



<cond> 

<or> 

<and> 

<exp> 

<op> 

<value> 



= [ "not" ] <or> 

= <and> I <and> " | " <or> 

= <exp> 1 <exp> "&" <and> 

= "(" <or> ")" I <value> <op> <value> 

_ II _ ti I II I _ n I n <; It I II ^ II 

= <arbitrary ASCII string> 



<numeric string> 
The available operators and their meanings are: 



! = 

& 


equal 
not equal 
and 


1 


or 


> 
< 


greater than 
less than 
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( ) used for logical groupings 

not may only occur inunediately after the i_f , and 

when present, inverts the value of the 

entire condition 

The > and < operate only on unsigned integer values (e. 
g.: 012 > 12 is false). All other operators take 
strings as arguments (e. g.: 012 != 12 is true). The 
precedence of the operators (from highest to lowest) 
is: 

= != > < all of equal precedence 
& 

I 
Parentheses may be used to alter the order of pre- 
cedence. 

Values must be separated from operators or parentheses 
by at least one blank or tab. 

: :text 

Used for keyword replacement on lines that are copied 
to the standard output. The two leading control char- 
acters are removed, and keywords surrounded by control 
characters in text are replaced by their value before 
the line is copied to the output file. This action is 
independent of the -a keyletter. 

:on 

:off 

Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and 
returns an exit code of 1. 

DIAGNOSTICS 

Use help (l) for explanations. 

EXIT CODES 

- normal 

1 - any error 
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NAME 

vi - screen oriented (visual) display editor based on ex 

SYNOPSIS 

vi [ -r ] [ + command ] [ -1 ] [ -wn ] name . . . 

DESCRIPTION 

Vi (visual) is a display oriented text editor based on 
ex(l). Ex and vi run the same code; it is possible to get 
to the command mode of ex from within W and vice-versa. 

The ULTRIX -11 Programmer's Guide and the Introduction to 
Display Editing with Vi provide full details on using vi. 

FILES 

See ex(l) . 

SEE ALSO 

ex (1), edit (1), "ULTRlX-11 Programmer's Guide", "An Intro- 
duction to Display Editing with Vi". 

AUTHOR 

William Joy 

Mark Horton added macros to visual mode and is maintaining 

version 3 

RESTRICTIONS 

Software tabs using "^T work only immediately after the 
auto indent . 

Left and right shifts on intelligent terminals don't make 
use of insert and delete character operations in the termi- 
nal. 

The wrapmargin option can be fooled since it looks at output 
columns when blanks are typed. If a long word passes 
through the margin and onto the next line without a break, 
then the line won't be broken. 

Insert/delete within a line can be slow if tabs are present 
on intelligent terminals, since the terminals need help in 
doing this correctly. 

Saving text on deletes in the named buffers is somewhat 
inefficient. 

The source command does not work when executed as : source; 
there is no way to use the tappend, :change, and : insert 
commands, since it is not possible to give more than one 
line of input to a : escape. To use these on a :global you 
must Q to ex command mode, execute them, and then reenter 
the screen editor with vl or open . 
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NAME 

volcopy, labelit - copy file systems with label checking 

SYNOPSIS 

/etc/volcopy [ options ] fsname speciall voll special2 vol2 

/etc/labelit special [ fsname voliome [ -n ] ] 

DESCRIPTION 

Volcopy makes a literal copy of the file system using a 
blocksize matched to the device. 

Options are: 

-a invoke a verification sequence requiring a posi- 
tive operator response. (This is the default.) 
-n do not ask before copying file systems. 

Other options are used only with tapes: 

-bpi density density in bits-per-inch 

(i.e., 800/1600/6250) , 
-feet size size of reel in feet (i.e., 1200/2400), 
-reelruHn beginning reel number num for a restarted 

copy, 
-buf use double buffered I/O. 

The program requests length and density information if it is 
not given on the command line or is not recorded on an input 
tape label. If the file system is too large to fit on one 
reel, volcopy will prompt for additional reels. Labels of 
all reels are checked. Tapes may be mounted alternately on 
two or more drives. 

The fsname argument represents the mounted name (e.g.: 
'root', 'usr', etc.) of the filsystem being copied. 

The special is the physical disk section or tape (e.g.: 
/dev/rdskl5, /dev/rmtO, etc.). 

The vol is the physical volume name (e.g.: pk3, t0122, etc.) 
and should match the external label sticker. Such label 
names are limited to six or fewer characters. Vol may be - 
to use the existing volume name. 

Speciall and voll are the device and volume from which the 
copy of the file system is being extracted. Special2 and 
vol2 are the target device and volume. 

Fsname and vol are recorded in the last 12 characters of the 
superblock Tchar fsname[6], volname[6] ; ) . 
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Label it can be used to provide initial labels for unmounted 
disk or tape file systems. With the optional arguments 
omitted, labelit prints current label values. The -n option 
provides for initial labeling of new tapes only (this des- 
troys previous contents). 



FILES 



/etc/log/f i lesave . log 



a record 
copied 



of file systems/volumes 



RESTRICTIONS 

Tape record sizes are determined both by density and by 
drive type. On DEC systems, records are 5,120 bytes long at 
800 and 1600 bits-per-inch, and 25,600 bytes long at 6250 
bits-per-inch. 
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NAME 

wait - await completion of process 

SYNOPSIS 
wait 

DESCRIPTION 

Wait until all processes started with & have completed, and 
report on abnormal terminations. 

Because the wait (2) system call must be executed in the 
parent process, the Shell itself executes wait, without 
creating a new process. 

SEE ALSO 
sh(l) 

RESTRICTIONS 

Not all the processes of a 3- or more-stage pipeline are 
children of the Shell, and thus can't be waited for. 
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NAME 

wall - write to all users 

SYNOPSIS 

/etc/wall 

DESCRIPTION 

Wall reads its standard input until an end-of-file. It then 
sends this message, preceded by 'Broadcast Message ...', to 
all logged in users. 

The sender should be super-user to override any protections 
the users may have invoked. 

FILES 

/dev/tty? 
/etc/utmp 

SEE ALSO 

mesg(l) , writed) 

DIAGNOSTICS 

'Cannot send to ...' when the open on a user's tty file 
fails. 
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NAME 



wc - word count 



SYNOPSIS 

wc [ -Iwc ] [ name ... ] 

DESCRIPTION 

Wc counts lines, words and characters in the named files, or 
In the standard input if no name appears. A word is a maxi- 
mal string of characters delimited by spaces, tabs or new- 
lines. 



If the optional argument is present, just the specified 
counts (lines, words or characters) are selected by the 
letters 1, w, or c. 
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NAME 

what - identify SCCS files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given files for all occurrences of the 
pattern that ^fi^l^ substitutes for %Z% (this is §(#) at 
this printing) and prints out what follows until the first 
", >, new-line, \, or null character. For example, if the C 
program in file f.c contains 

char ident[] = "@(#) identification information"; 
and f.c is compiled to yield f.o and a. out, then the command 

what f.c f.o a. out 
will print 



f.c: 
f.o: 
a. out; 



identification information 
identification information 
identification information 



What is intended to be used in conjunction with the command 

get (l) , which automatically inserts identifying information, 

but it can also be used where the information is inserted 
manually. 

SEE ALSO 

get(l), help(l). 

DIAGNOSTICS 

Use help (l) for explanations. 

RESTRICTIONS 

It's possible that an unintended occurrence of the pattern 
@(#) could be found just by chance, but this causes no harm 
in nearly all cases. 



WHO(l) WHO(l) 



NAME 

who - who is on the system 

SYNOPSIS 

who [ who-file ] [ am I ] 

DESCRIPTION 

Who , without an argument, lists the login name, terminal 
name, and login time for each current UNIX user. 

Without an argument, who examines the /etc/utmp file to 
obtain its information. If a file is given, that file is 
examined. Typically the given file will be /usr/adm/wtmp, 
which contains a record of all the logins since it was 
created. Then who lists logins, logouts, and crashes since 
the creation of the wtmp file. Each login is listed with 
user name, terminal name (with '/dev/' suppressed), and date 
and time. When an argument is given, logouts produce a 
similar line without a user name. Reboots produce a line 
with 'x' in the place of the device name, and a fossil time 
indicative of when the system went down. 

With two arguments, as in 'who am I' (and also 'who are 
you'), who tells who you are logged in as. 

FILES 

/etc/utmp 

SEE ALSO 

getuid(2), utmp(5) 
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NAME 

whoami - print effective current user id 

SYNOPSIS 

whoami 

DESCRIPTION 

Whoami prints who you are. It works even if you are su'd, 
while 'who am i' does not since it uses /etc/utmp. 

FILES 

/etc/passwd 

SEE ALSO 

who (1) 

AUTHOR 

Bill Joy 
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NAME 

write - write to another user 

SYNOPSIS 

write user [ ttyname ] 

DESCRIPTION 

Write copies lines from your terminal to that of another 
user. When first called, it sends the message 

Message from yourname yourttyname. . . 

The recipient of the message should write back at this 
point. Communication continues until an end of file is read 
from the terminal or an interrupt is sent. At that point 
write writes 'EOT' on the other terminal and exits. 

If you want to write to a user who is logged in more than 
once, the ttyname argument may be used to indicate the 
appropriate terminal name. 

Permission to write may be denied or granted by use of the 
mesg command. At the outset writing is allowed. Certain 
commands, in particular nrof f and 2£d) disallow messages in 
order to prevent messy output. 

If the character ' ! ' is found at the beginning of a line, 
write calls the shell to execute the rest of the line as a 
command. 

The following protocol is suggested for using write ; when 
you first write to another user, wait for him to write back 
before starting to send. Each party should end each message 
with a distinctive signal-(o) for 'over' is conventional- 
that the other may reply. (oo) for 'over and out' is sug- 
gested when conversation is about to be terminated. 

FILES 

/etc/utmp to find user 
/bin/sh to execute ' ! ' 

SEE ALSO 

mesg(l), who{l), mail(l) 
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NAME 

xstr - extract strings from C programs to implement shared 
strings 

SYNOPSIS 

xstr [ -c ] [ - ] [ file ] 

DESCRIPTION 

Xstr maintains a file strings into which strings in com- 
ponent parts of a large program are hashed. These strings 
are replaced with references to this common area. This 
serves to implement shared constant strings, most useful if 
they are also read-only. 

The command 

xstr -c name 

will extract the strings from the C source in name, replac- 
ing string references by expressions of the form 
( &xstr[ number ] ) for some number. An appropriate declaration 
°f xstr is prepended to the file. The resulting C text is 
placed in the file x«£» to then be compiled. The strings 
from this file are placed in the strings data base if they 
are not there already. Repeated strings and strings which 
are suffices of existing strings do not cause changes to the 
data base. 

After all components of a large program have been compiled a 
file xs.c declaring the common xstr space can be created by 
a command of the form 

xstr 

This xs.c file should then be compiled and loaded with the 
rest of the program. If possible, the array can be made 
read-only (shared) saving space and swap overhead. 

Xstr can also be used on a single file. A command 

xstr name 

creates files x.c and xs.c as before, without using or 
affecting any strings file in the same directory. 

It may be useful to run xstr after the C preprocessor if any 
macro definitions yield strings or if there is conditional 
code which contains strings which may not, in fact, be 
needed. Xstr reads from its standard input when the argu- 
ment '-' is given. An appropriate command sequence for run- 
ning xstr after the C preprocessor is: 
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cc -E name.c I 

cc -c x.c 

mv x.o name.o 



xstr -c - 



Xstr does not touch the file strings unless new items are 
added, thus make can avoid remaking xs.o unless truly neces- 
sary. 



FILES 

strings 
x.c 
xs.c 
/tmp/xs* 

SEE ALSO 

mkstr(l) 



Data base of strings 

massaged C source 

C source for definition of array 'xstr' 

temporary file for 'xstr name' strings 



AUTHOR 

Bill Joy 

RESTRICTIONS 

If a string is a suffix of another string in the data base, 
but the shorter string is seen first by xstr both strings 
will be placed in the data base, when just placing the 
longer one there will do. 
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NAME 

yacc - yet another compiler-compiler 

SYNOPSIS 

yacc [ -vd ] grammar 

DESCRIPTION 

Yacc converts a context-free grammar into a set of tables 
for a simple automaton which executes an LR(1) parsing algo- 
rithm. The grammar may be ambiguous; specified precedence 
rules are used to break ambiguities. 

The output file, y. tab .c, must be compiled by the C compiler 
to produce a program yyparse . This program must be loaded 
with the lexical analyzer program, yylex , as well as main 
and yyerror , an error handling routine. These routines must 
be supplied by the user; Lex(l) is useful for creating lexi- 
cal analyzers usable by yacc . 

Ifthe -V flag is given, the file y. output is prepared, 
which contains a description of the parsing tables and a 
report on conflicts generated by ambiguities in the grammar. 

If the -d flag is used, the file y. tab .h is generated with 
the define statements that associate the yacc -assiqned 
'token codes' with the user-declared 'token names'. This 
allows source files other than y. tab .c to access the token 
codes. 

FILES 

y. output 
y.tab.c 

y.tab.h defines for token names 

yacc.tmp, yacc. acts temporary files 
/usr/lib/yaccpar parser prototype for C programs 
/lib/liby.a library with default 'main' and 'yyer- 
ror' 

SEE ALSO 

lex(l) 

LR Parsing by A. V. Aho and S. C. Johnson, Computing Sur- 
veys, June, 1974. 
YACC - Yet Another Compiler Compiler by S. C. Johnson. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce conflicts is 
reported on the standard output; a more detailed report is 
found in the y. output file. Similarly, if some rules are 
not reachable from the start symbol, this is also reported. 
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NAME 

zaptty - run a program without a controlling terminal. 

SYNOPSIS 

zaptty command 

DESCRIPTION 

Zaptty will disassociate itself from it's controlling termi- 
nal, and then exec the specified command. This is useful 
for re-starting daemons that have died for some reason, and 
don't want to be associated with any terminal when they are 
re-started. 

Zaptty is restricted to the super-user. 

SEE ALSO 

zaptty(2), nohup(l) 
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NAME 

intro, errno - introduction to system calls and error 
numbers 

SYNOPSIS 

finclude <errno.h> 

DESCRIPTION 

Section 2 of this manual lists all the entries into the sys- 
tem. Most of these calls have an error return. An error 
condition is indicated by an otherwise impossible returned 
value. Almost always this is -1; the individual sections 
specify the details. An error n\amber is also made available 
in the external variable errno. Errno is not cleared on 
successful calls, so it should be tested only after an error 
has occurred. 

There is a table of messages associated with each error, and 
a routine for printing the message; See perror Q) . The pos- 
sible error numbers are not recited with each writeup in 
section 2, since many errors are possible for most of the 
calls. Here is a list of the error numbers, their names as 
defined in <errno.h>, and the messages available using per- 
ror. 

Error 
Unused. 

1 EPERM Not owner 

Typically this error indicates an attempt to modify a 
file in some way forbidden except to its owner or 
superuser. It is also returned for attempts by ordi- 
nary users to do things allowed only to the superuser. 

2 ENOENT No such file or directory 

This error occurs when a file name is specified and the 
file should exist but doesn't, or when one of the 
directories in a path name does not exist. 

3 ESRCH No such process 

The process whose number was given to signal and ptrace 
does not exist, or is already dead. 

4 EINTR Interrupted system call 

An asynchronous signal (such as interrupt or quit), 
which the user has elected to catch, occurred during a 
system call. If execution is resumed after processing 
the signal, it will appear as if the interrupted system 
call returned this error condition. 

5 EIO I/O error 

Some physical I/O error occurred during a read or 
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write. This error may in some cases occur on a call 
following the one to which it actually applies. 

6 ENXIO No such device or address 

I/O on a special file refers to a subdevice that does 
not exist, or beyond the limits of the device. It may 
also occur when, for example, a tape drive is not 
dialled in or no disk pack is loaded on a drive. 

7 E2BIG Arg list too long 

An argument list longer than 5120 bytes is presented to 
exec . 

8 ENOEXEC Exec format error 

A request is made to execute a file which, although it 
has the appropriate permissions, does not start with a 
valid magic number, see a. out (5) . 

9 EBADF Bad file nxomber 

Either a file descriptor refers to no open file, or a 
read (resp. write) request is made to a file that is 
open only for writing (resp. reading). 

10 ECHILD No children 

^^\t and the process has no living or unwaited-for 
children. 

11 EAGAIN No more processes 

In a fork, the system's process table is full or the 
user IS not allowed to create any more processes. 

12 ENOMEM Not enough core 

During an exec or break , a program asks for more core 
than the system is able to supply. This is not a tem- 
porary condition; the maximum core size is a system 
parameter. The error may also occur if the arrangement 
of text, data, and stack segments requires too many 
segmentation registers. 

13 EACCES Permission denied 

An attempt was made to access a file in a way forbidden 
by the protection system. 

14 EFAULT Bad address 

The system encountered a hardware fault in attempting 
to access the arguments of a system call. 

15 ENOTBLK Block device required 

A plain file was mentioned where a block device was 
required, e.g. in mount. 
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16 EBUSY Mount device busy 

An attempt to mount a device that was already mounted 
or an attempt was made to dismount a device on which 
there is an active file (open file, current directory, 
mount ed-on file, active text segment). 

17 EEXIST File exists 

An existing file was mentioned in an inappropriate con- 
text, e.g. link . 

18 EXDEV Cross-device link 

A link to a file on another device was attempted. 

19 ENODEV No such device 

An attempt was made to apply an inappropriate system 
call to a device; e.g. read a write-only device. 

20 ENOTDIR Not a directory 

A non-directory was specified where a directory is 
required, for example in a path name or as an argument 
to chdir. 



21 



22 



23 



24 



EISDIR Is a directory 
An attempt to write on a directory. 

EINVAL Invalid argument 
Some invalid argument: dismounting a non-mounted dev- 
ice, mentioning an unknown signal in signal , reading or 
writing a file for which seek has generated a negative 
pointer. Also set by math functions, see introO) . 



ENFILE File table overflow 
The system's table of open files is full, 
porarily no more opens can be accepted. 



and tem- 



EMFILE Too many open files 
Customary configuration limit is 20 per process. 



25 ENOTTY Not a typewriter 

The file mentioned in stty or gtty is not a terminal or 
one of the other devices to which these calls apply. 

26 ETXTBSY Text file busy 

An attempt to execute a pure-procedure program that is 
currently open for writing (or reading!). Also an 
attempt to open for writing a pure-procedure program 
that is being executed. 



27 EFBIG File too large 

The size of a file exceeded the 
bytes) . 



max imum ( about 1 . 0E9 
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28 ENOSPC No space left on device 

During a write to an ordinary file, there is no free 
space left on the device. 

29 ESPIPE Illegal seek 

An Iseek was issued to a pipe. This error should also 
be issued for other non-seekable devices. 

30 EROFS Read-only file system 

An attempt to modify a file or directory was made on a 
device mounted read-only. 

31 EMLINK Too many links 

An attempt to make more than 32767 links to a file. 

32 EPIPE Broken pipe 

A write on a pipe for which there is no process to read 
the data. This condition normally generates a signal; 
the error is returned if the signal is ignored. 

33 EDOM Math argument 

The argument of a function in the math package (3M) is 
out of the domain of the function. 

34 ERANGE Result too large 

The value of a function in the math package (3M) is 
unrepresentable within machine precision. 

35 ETPL Fatal error - tape position lost 

A magtape driver has encountered a tape error that has 
caused it to loose track of tape position. 

36 ETOL Tape unit off-line 

An attempt has been made to access a tape drive that is 
not available, i.e., no tape loaded or off-line. 

37 ETWL Tape unit write locked 

A write operation was attempted on a tape without a 
write enable ring installed. 

38 ETO Tape unit already open 

Caused by an attempt to access a tape drive that is 
already in use or is hung for some reason. 

SEE ALSO 

intro{3) 

RESTRICTIONS 

The getfpO, bdflushO, errlogO, and ttloclO system calls 
are intentionally not documented. These calls are reserved 
for use by ULTRIX-11 system programs and must not be called 
by any user process. 
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ASSEMBLER 

as /usr/include/sys.s file ... 

The PDPll assembly language interface is given for each sys- 
tem call. The assembler symbols are defined in 
' /usr/include/sys.s' . 

Return values appear in registers rO and rl; it is unwise to 
count on these registers being preserved when no value is 
expected. An erroneous call is always indicated by turning 
on the c-bit of the condition codes. The error number is 
returnea in rO. The presence of an error is most easily 
tested by the instructions bes and bee ('branch on error set 
(or clear)'). These are synonyms for the bcs and bcc 
instructions. 

On the Interdata 8/32, the system call arguments correspond 
well to the arguments of the C routines. The sequence is: 

la %2,errno 
1 %0,&callno 
SVC 0,args 

Thus register 2 points to a word into which the error number 
will be stored as needed; it is cleared if no error occurs. 
Register contains the system call number; the nomenclature 
is identical to that on the PDPll. The argument of the svc 
is the address of the arguments, laid out in storage as in 
the C calling sequence. The return value is in register 2 
(possibly 3 also, as in pipe ) and is -1 in case of error. 
The overflow bit in the program status word is also set when 
errors occur. 
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NAME 



access - determine accessibility of file 



SYNOPSIS 

access (name, mode) 
char *name; 

DESCRIPTION 

Access checks the given file name for accessibility accord- 
ing to mode, which is 4 (reaciT7"2 (write) or 1 (execute) or 
a combination thereof. Specifying mode tests whether the 
directories leading to the file can be searched and the file 
exists. 

An appropriate error indication is returned if name cannot 
be found or if any of the desired access modes ^IrauTd not be 
granted. On disallowed accesses -1 is returned and the 
error code is in errno. is returned from successful 
tests. 



The user and group IDs with respect to which permission is 
checked are the real UID and GID of the process, so this 
call is useful to set-UID programs. 

Notice that it is only access bits that are checked. A 
directory may be announced as writable by access, but an 
attempt to open it for writing will fail (although files may 
be created there); a file may look executable, but exec will 
rail unless it is in proper format. 



DIAGNOSTICS 
Access 



to the file is denied if: 



[EACCES] 
[EACCES] 



[EROFS] 
[ETXTBSY] 



Permission bits of the file mode do not 
mit the requested access. 



per- 



Search permission is 
the path prefix, 
permission checked 
'owner' read, write 
Members of the file's 
owner have permission 
the 'group' mode bits 
permissions checked 
'other' mode bits. 



denied on a component of 

The owner of a file has 

with respect to the 

and execute mode bits. 

group other than the 

checked with respect to 

and all others have 

with respect to the 



a file 



on 



Write access is requested for 
read-only file system. 

Write access is requested for a pure pro- 
cedure (shared text) file that is being exe- 
cuted. 
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SEE ALSO 

Stat (2) 

ASSEMBLER 

(access = 33.) 

sys access; name; mode 
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NAME 

acct - turn accounting on or off 

SYNOPSIS 

acct(f ile) 
char *file; 

DESCRIPTION 

The system is prepared to write a record in an accounting 
file for each process as it terminates. This call, with a 
null-terminated string naming an existing file as argument 
turns on accounting; records for each terminating process 
be^tu^nld off^° ^^' ^" argument of causes accounting to 

The accounting file format is given in acct(5). 

On error -1 is returned. The file must exist and the call 
may be exercised only by the superuser. it is erroneous to 
try to turn on accounting when it is already on. 

DIAGNOSTICS 

A<^ct will fail if one of the following is true: 

[EACCES] File is not a regular file. 



[EBUSY] 

[ EFAULT ] 



An attempt is made to turn on accounting when 
It is already on. 

Pile points outside the process's allocated 
address space. 



[ENOENT] The named file does not exist. 



[ENOTDIR] 



A component of the path prefix is not a 
directory. 



[EPERM] The caller is not the superuser. 
[EROFS] The file resides on a read-only file system. 
RESTRICTIONS 

No accounting is produced for programs running when a crash 
account d f" P^'^^^^^^^'^ nonterminating programs are never 

SEE ALSO 

acct(5), sa(l) 

ASSEMBLER 

(acct = 51.) 
sys acct; file 
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NAME 

alarm - schedule signal after specified time 

SYNOPSIS 

alarm( seconds) 
unsigned seconds; 

DESCRIPTION 

Alarm causes signal SIGALRM, see siqnal (2) , to be sent to 
the invoking process in a number of seconds given by the 
argument. Unless caught or ignored, the signal terminates 
the process. 

Alarm requests are not stacked; successive calls reset the 
alarm clock. If the argument is 0, any alarm request is 
cancelled. Because the clock has a 1-second resolution, the 
signal may occur up to one second early; because of schedul- 
ing delays, resumption of execution of when the signal is 
caught may be delayed an arbitrary amount. The longest 
specifiable delay time is 65535 seconds. 

The return value is the amount of time previously remaining 
in the alarm clock. 

SEE ALSO 

pause(2), signal(2), sleepO) 

ASSEMBLER 

(alarm = 27. ) 

(seconds in rO) 

sys alarm 

(previous amount in rO) 
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NAME 



brk, sbrk, break - change core allocation 



SYNOPSIS 

char *brk{addr) 

char *sbrk(incr) 

DESCRIPTION 

Brk sets the system's idea of the lowest location not used 
by the program (called the break) to addr (rounded up to the 
next multiple of 64 bytes on the PDPlTr~256 bytes on the 
nterdata 8/32, 512 bytes on the VAX-li/780). Locations not 
less than addr and below the stack pointer are not in ?Se 

accessed. ^^^" ^""^ """^^ '^^^ """^^ ^ '"^'"^^y violation if 

JL^^S.^^^^'"?^^^^'''''^^'°'' ^^^' iil^ '"o^e bytes are added to 
the program's data space and a-^nter to the start of the 
new area is returned. =>^an. oi zne 

When a program begins execution via exec the break is set at 

^rL = '^^^^^°''•^'°" defined by the pFSgram and data storage 

areas. Ordinarily, therefore, only programs with growing 

data areas need to use break . yruwing 

RETURN VALUE 

Zero is returned if the break could be set; -1 if the oro- 

mln^ JJ'^''^t^f' """^^ .memory than the system limit or if too 

the breir'' "" registers would be required to implement 



DIAGNOSTICS 

Sbrk will fail and no additional memory 

if: ^ 



will be allocated 



[ENOMEM] 
[ENOMEM] 



The maximum possible size of a data segment 
(compiled into the system) was exceeded. 

The maximum available memory for a user pro- 
cess was exceeded. For l/D process, text or 
data+stack was larger than 64KB. For non-I/D 
process, text+data+stack was larger than 
64KB . 



RESTRICTIONS 

Setting the break in the range 0177701 to 0177777 
PDPll) is the same as setting it to zero. 

SEE ALSO 

exec(2), mallocO), end(3) 



(on the 
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NAME 

dup, dup2 - duplicate an open file descriptor 

SYNOPSIS 

dup(f ildes) 
int fildes; 

dup2(f ildes, fildes2) 
int fildes, fildes2; 

DESCRIPTION 

Given a file descriptor returned from an open , pipe , or 
creat call, du2 allocates another file descriptor synonymous 
with the original. The new file descriptor is returned. 

In the second form of the call, fildes is a file descriptor 
referring to an open file, and fildes2 is a non-negative 
integer less than the maximum value allowed for file 
descriptors (approximately 19). Dup2 causes f ildes2 to 
refer to the same file as fildes . If f ildes2 already 
referred to an open file, it is closed first"; 

DIAGNOSTICS 

Dup and dup 2 will fail if: 

[EBADF] Fildes or fildes2 is not a valid active 
descriptor. 

[EMFILE] Too many descriptors are active. 

SEE ALSO 

creat(2), open(2), close(2), pipe(2) 

ASSEMBLER 

(dup =41.) 

(file descriptor in rO) 

(new file descriptor in rl) 

sys dup 

(file descriptor in rO) 

The dup 2 entry is implemented by adding 0100 to fildes . 
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ASSEMBLER 

(break =17.) 
sys break; addr 

Break performs the function of brk. The name of the routine 
differs from that in C for historical reasons. 
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NAME 

chdir, chroot - change default directory 

SYNOPSIS 

chdir(dirname) 
char *dirname; 

chroot (dirname) 
char *dirname; 

DESCRIPTION 

Z\im% 'k ^^® address of the pathname of a directory, ter- 
minated by a null byte. Chdir causes this directory to 
nfJ^L current working directory, the starting point for 
path names not beginning with •/'. 

g|l22t sets the root directory, the starting point for path 
superuser!'""'''^ ^''"^ '^'- ^^^ "^ is Restricted to'^^he 

RETURN VALUE 

?r°.hf ^l^''^''^^ if the directory is changed; -1 is returned 
searcSlblf!''^" "^^ '^ "°' ^*^^' °^ ^ directory or is not 

DIAGNOSTICS 

Chdir will fail and the current working directory will be 
unchanged if one or more of the following is truef 

[EACCES] Search permission is denied for a component 
of the path name. 



[EFAULT] 

[ENFILE] 
[ENOENT] 

[ENOTDIR] 



Dirname points outside the process's allo- 
cated address space. 

Insufficient system space to contain i-node. 

The named directory, or an element within the 
named path, does not exist. 

A component of the path name is not a direc- 
tory. 



Chroot will also fail if: 



[EPERM] 
SEE ALSO 

cd(l) 

ASSEMBLER 

(chdir = 12.) 



The user is not the superuser. 
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sys chdir; dirname 



(chroot = 61. ) 

sys chroot; dirname 
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NAME 

chmod - change mode of file 

SYNOPSIS 

chmod (name, mode) 
char *name; 

DESCRIPTION 

nnfn^in^ "i^""?.^ ""^^ t^ ^^""^^ ^^ ^^^ null-terminated string 
pointed to by name has its mode changed to mode. Modes are 

loSfng: "^ ^^^ together some combinati^f tSe fol- 

04000 set user ID on execution 

02000 set group ID on execution 

01000 save text image after execution 

00400 read by owner 

00200 write by owner 

SSnSS ^^®^^t« (search on directory) by owner 

nnnnS ""^^2' '"''*'®' ^^^c^te (search) by group 

00007 read, write, execute (search) by others 



if fS/f^T^'i'u^^^® ^'^^ ^^ ^^t "P fo^ sharing (-n or -i option 
tL^lVJ ''*'^" '^^^^ ^°°° prevents the systim from abandon ng 
ih!n ?^^P?''^'"'^^^ °^ ^^^ program-text portion of the f ul 
thffn^^ last user terminates. Thus when the next user of 
the file executes it, the text need not be read from the 

liuitJ^to'Lt^rh- "S". ^'""P^^ ^^ ^^^PP^^ in? savlng'time! 
Ability to set this bit is restricted to the superuser since 

swap space is consumed by the images; it is onl? worth whi" 
for heavily used commands. ^ wortn wniie 

mall ^^nn?rfH ""^ ^ ^'^^ ^or the superuser) may change the 
mode. Only the superuser can set the 1000 mode. 

RETURN VALUE 

Zero is returned if the mode is changed; -1 is returned if 

SrThr???e nor'?h2^ °' '' '^^'"^^^ "'^^ ^^ "^^^^^^ the own^r 
or tne tile nor the superuser. 

DIAGNOSTICS 

Chmod will fail and the file mode will be unchanged if: 

[EACCES] Search permission is denied on a component of 
the path prefix. 

[EFAULT] Name points outside the process's allocated 
address space. 



[ENFILE] 
[ENOENT] 



Insufficient system space to contain i-node. 
The named file, or an element within the 
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[ENOTDIR] 
[EPERM] 

[EROFS] 



SEE ALSO 

chmod(l) 



named file, does not exist. 

A component of the path prefix is 
directory. 



not 



The effective user ID does not match the 
owner of the file and the effective user ID 
is not the superuser. 



The named file resides on 
system. 



a read-only file 



ASSEMBLER 

(chmod = 15.) 

sys chmod; name; mode 
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NAME 

chown - change owner and group of a file 

SYNOPSIS 

chown (name, owner, group) 
char *name; 

DESCRIPTION 

The file whose name is given by the null-terminated string 
pointed to by name has its owner and group changed as speci- 
fied. Only the superuser may execute this call, because if 
users were able to give files away, they could defeat the 
(nonexistent) file-space accounting procedures. 

RETURN VALUE 

Zero is returned if the owner is changed; -1 is returned on 
illegal owner changes. 

DIAGNOSTICS 

Chown will fail and the file will be unchanged if: 

[EACCES] Search permission is denied on a component of 
the path prefix. 

[EFAULT] Name points outside the process's allocated 
address space. 

[ENFILE] Insufficient system space to contain i-node. 

[ENOENT] The named file, or an element within path 
name, does not exist. 

[ENOTDIR] A component of the path prefix is not a 
directory. 

[EPERM] The effective user ID does not match the 
owner of the file and the effective user ID 
is not the superuser. 

[EROFS] The named file resides on a read-only file 
system. 

SEE ALSO 

chown(l), passwd(5) 

ASSEMBLER 

(chown = 16. ) 

sys chown; name; owner; group 
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NAME 

close - close a file 

SYNOPSIS 

close(f ildes) 

DESCRIPTION 

Given a file descriptor such as returned from an open , 
creat, dup or pipe (2) call, close closes the associated 
file. A close of all files is automatic on exit., but since 
there is a limit on the number of open files per process, 
close is necessary for programs which deal with many files. 

Files are closed upon termination of a process, and certain 
file descriptors may be closea by exec (2) (see ioctl (2) ) . 

RETURN VALUE 

Zero is returned if a file is closed; -1 is returned for an 
unknown file descriptor. 

DIAGNOSTICS 

Close will fail if: 

[EBADF] Fildes is not an active descriptor. 

SEE ALSO 

creat(2), open(2), pipe(2), exec(2), ioctl(2) 

ASSEMBLER 

(close = 6.) 

(file descriptor in rO) 

sys close 
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NAME 

creat - create a new file 

SYNOPSIS 

creat (name, mode) 
char *name; 

DESCRIPTION 

Creat creates a new file or prepares to rewrite an existing 
file called name , given as the address of a null-terminated 
string. If the file did not exist, it is given mode mode , 
as modified by the process's mode mask (see \imask (2) ) . Also 
see chmod (2) for the construction of the mode argument. 

If the file did exist, its mode and owner remain unchanged 
but it is truncated to length. 

The file is also opened for writing, and its file descriptor 
is returned. 

The mode given is arbitrary; it need not allow writing. 
This feature is used by programs which deal with temporary 
files of fixed names. The creation is done with a mode that 
forbids writing. Then if a second instance of the program 
attempts a creat , an error is returned and the program knows 
that the name is unusable for the moment. 

RETURN VALUE 

Zero is returned if the file is created; -1 is returned oth- 
erwise. 

DIAGNOSTICS 

Creat will fail and the file will not be created if: 

[EACCES] A component of the path prefix denies search 
permission. 

[EACCES] The directory in which the file is to be 
created is not writable by the user. 

[EFAULT] Name points outside the process's allocated 
address space. 

[EISDIR] The named file is a directory. 

[EMFILE] The maximum number of file descriptors 
allowed are already open. 

[ENFILE] No more system file descriptors are avail- 
able, or there is insufficient system space 
to contain the i-node. 
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[ENOENT] 
[ENOTDIR] 

[ENXIO] 

[EROFS] 
[ETXTBSY] 



Element within path name does not exist. 

A component of the path prefix is not a 
directory. 

Device special file within name is not for 
the current system (major device nvamber is 
greater than "nchrdev"). 

The directory in which the file is to be 
created is on a read-only file system. 

The file is a pure procedure (shared text) 
file that is being executed. 



SEE ALSO 

write(2), close(2), chmod(2), umask (2) 

ASSEMBLER 

(creat =8.) 

sys creat; name; mode 

(file descriptor in rO) 
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NAME 

ac - login accounting 

SYNOPSIS 

ac [ -w wtmp ] [ -p ] [ -d ] [ people ] ... 

DESCRIPTION 

Ac produces a printout giving connect time for each user who 
has logged in during the life of the current vtmp file. A 
total is also produced, -w is used to specify an alternate 
vtmp file. -p prints individual totals; without this 
option, only totals are printed, -d causes a printout for 
each midnight to midnight period. Any people will limit the 
printout to only the specified login names. If no wtmp file 
is given, / usr / adm / wtmp is used. 

The accounting file / us r / adm / wtmp is maintained by init and 
login . Neither of these programs creates the file, so if it 
does not exist no connect-time accounting is done. To start 
accounting, it should be created with length 0. On the 
other hand if the file is left undisturbed it will grow 
without bound, so periodically any information desired 
should be collected and the file truncated. 

FILES 

/usr/adm/wtmp 

SEE ALSO 

init(8), login(l), utmp(5). 
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NAME 

execl, execv, execle, execve, execlp, execvp, exec, exece, 
environ - execute a file 

SYNOPSIS 

execKname, argO, argl, ..., argn, 0) 
char *name, *argO, *argl, ..., *argn; 

execv(name, argv) 
char *name, *argv[ ]; 

execle(name, argO, argl, ..., argn, 0, envp) 
char *naine, *argO, *argl, ..., *argn, *envp[ ] ; 

execve (name, argv, envp); 

char *name, *argv[ ], *envp[ ] ; 

extern char **environ; 

DESCRIPTION 

Exec in all its forms overlays the calling process with the 
named file, then transfers to the entry point of the core 
image of the file. There can be no return from a successful 
exec; the calling core image is lost. 

Files remain open across exec unless explicit arrangement 
has been made; see ioctl (2) . Ignored signals remain ignored 
across these calls, but signals that are caught (see sig- 
nal (2) ) are reset to their default values. 

Each user has a real user ID and group ID and an effective 
user ID and group ID. The real ID identifies the person 
using the system; the effective ID determines his access 
privileges. Exec changes the effective user and group ID to 
the owner of the executed file if the file has the 'set- 
user-ID' or 'set-group- ID 'modes. The real user ID is not 
affected. 

The name argument is a pointer to the name of the file to be 
executed. The pointers arg [0] , arg [l] ... address null- 
terminated strings. Conventionally argT O] is the name of 
the file. 

From C, two interfaces are available. Execl is useful when 
a known file with known arguments is being called; the argu- 
ments to execl are the character strings constituting the 
file and the arguments; the first argument is conventionally 
the same as the file name (or its last component). A 
argument must end the argument list. 

The execv version is useful when the number of arguments is 
unknown in advance; the arguments to execv are the name of 
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the file to be executed and a vector of strings containing 
the arguments. The last argument string must be followed by 
a pointer. 

When a C program is executed, it is called as follows: 

main(argc, argv, envp) 

int argc; 

char **argv, **envp; 

where argc is the argument count and argv is an array of 
character pointers to the arguments themselves. As indi- 
cated, argc is conventionally at least one and the first 
member of the array points to a string containing the name 
of the file. 

Argv is directly usable in another execv because argv[arqc] 
IS 0. — ^ ^*— 

EJ^vp is a pointer to an array of strings that constitute the 
environment of the process. Each string consists of a name, 
an "=", and a null-terminated value. The array of pointers 
is terminated by a null pointer. The shell sh(l) passes an 
environment entry for each global shell variable defined 
when the program is called. See environ (5) for some conven- 
tionally used names. The C run-time start-off routine 
places a copy of envp in the global cell environ , which is 
used by execv and execl to pass the environment to any sub- 
programs executed by the current program. The exec routines 
use lower-level routines as follows to pass an environment 
explicitly: 

execle(file, argO, argl, . . . , argn, 0, environ); 

execve(file, argv, environ); 

E^eclp and execvp are called with the same argioments as 
execl and execv , but duplicate the shell's actions in 
searching for an executable file in a list of directories. 
The directory list is obtained from the environment. 

FILES 

/bin/sh shell, invoked if command file found by execlp or 
execvp ^ 

RETURN VALUE 

If exec returns to the calling process an error has 
occurred; the return value will be -1 and the global vari- 
able' errno will contain an error code. 

DIAGNOSTICS 

Exec will fail and return to the calling process if one or 
more of the following is true: 
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[EACCES] 

[EACCES] 

[EACCES] 
[EFAULT] 

[EFAULT] 

[ENFILE] 
[ENOENT] 

[ENOENT] 
[ENOEXEC] 

[ENOEXEC] 
[ENOEXEC] 

[ENOEXEC] 
[ENOEXEC] 
[ENOMEM] 

[ENOTDIR] 

[ETXTBSY] 



Search permission is denied for a directory 
listed in the new process file's path prefix. 

The new process file mode denies execute per- 
mission. 

The new process file is not a regular file. 

Name points outside the process's allocated 
address space. 

Name , argv , or envp point to an illegal 
address (outside of the user's image). 

Insufficient system space to contain i-node. 

One or more components of the new process 
file's path name does not exist. 

The target file is a directory. 

The new process file has the appropriate 
access permission but the file header con- 
tains an invalid magic number. 

The text or data segment is null. 

An overlay is larger than the overlay max 
size. 

Unable to read file header. 

Found a bad magic number in the file header. 

The new process requires more memory than is 
allowed. 

A component of the new process path name is 
not a directory. 

The new process file is a pure procedure 
(shared text) file that is currently open for 
reading or writing by some process. 



RESTRICTIONS 

If execvp is called to execute a file that turns out to be a 
shell command file, and if it is impossible to execute the 
shell, the values of argv [0] and argv [-l] will be modified 
before return. 



SEE ALSO 

fork(2), environ(5) 
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ASSEMBLER 

(exec = 11.) 

sys exec; name; argv 

(exece = 59. ) 

sys exece; name; argv; envp 

Plain exec is obsoleted by exece , but remai 
reasons. 



ns for historical 



When the called file starts execution on the PDPll the 
stack pointer points to a word containing the number of 
arguments. Just above this number is a list of pointers to 
the argument strings, followed by a null pointer, followed 
by the pointers to the environment strings and then another 

?"";. ?°ill^^''- "^^^ strings themselves follow; a word is 
left at the very top of memory. 



sp-> 
argO 


nargs 


• • • 

argn 





envO 




• • • 

envm 





argO: 


<argO\0> 


• • • 

envO: 



<envO\0> 



n'l'Jo^ Jnterdata 8/32, the stack begins at a conventional 
place (currently OxDOOOO) and grows upwards. After exec 
the layout of data on the stack is as follows. ' 



int 



argO: 


byte . . . 


• • • 

argpO: 


int argO 


• • • 

int 





envpO : 


int envO 


• • • 

int 





%2-> 

int 
int 
int 


space 
nargs 
argpO 
envpO 



40 



%3-> 



EXEC(2) E^^^<2) 



This arrangement happens to conform well to C calling con- 
ventions. 
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NAME 

exit - terminate process 

SYNOPSIS 

exit(status) 
int status; 

^exit(status) 
Tnt status; 

DESCRIPTION 

|xit is the normal means of terminating a process Exit 
H^es all the process's files and notifies the pa^^nt 1?^ 
cess If It is executing a wait. The low-order 8 h?t/ of 
status are available to thF^rent process? ^'^^ °^ 

This call can never return. 

anal ''sys'^exTi^ "^'^hf^f ^^^^^"P ^^^^°"^ ^«f°r« the 
cleanup. * function exit circumvents all 

SEE ALSO 

wait(2) 

ASSEMBLER 

(exit = 1.) 
(status in rO) 
sys exit 
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NAME 



fork - spawn new process 



SYNOPSIS 

fork( ) 

DESCRIPTION 

Fork is the only way new processes are created. The new 
process's core image is a copy of that of the caller of 
fork . The only distinction is the fact that the value 
returned in the old (parent) process contains the process ID 
of the new (child) process, while the value returned in the 
child is 0. Process ID's range from 1 to 30,000. This pro- 
cess ID is used by wait (2). 

Files open before the fork are shared, and have a common 
read-write pointer. In particular, this is the way that 
standard input and output files are passed and also how 
pipes are set up. 

RETURN VALUE , ^ « ^ .u 

Upon successful completion, fork returns a value of to the 
child process and returns the process ID of the child pro- 
cess to the parent process. Otherwise, a value of -1 is 
returned to the parent process, no child process is created, 
and the global variable errno is set to indicate the error. 

Only the superuser can take the last process-table slot. 

DIAGNOSTICS ^ _ 

Fork will fail and no child process will be created if: 



[EAGAIN] 



[EAGAIN] 



[ENOMEM] 



The system- imposed limit on the total number 
of processes under execution would be 
exceeded. 

The system- imposed limit on the total nximber 
of processes under execution by a single user 
would be exceeded. 

There is no swap space available for "max- 
mem" . 



SEE ALSO 

wait(2), exec(2) 

ASSEMBLER 

(fork =2.) 

sys fork 

(new process return) 

(old process return. 



new process ID in rO) 
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The return locations in the old and new process differ bv 
one word The C-bit is set in the old process if a new pro- 
cess could not be created. ^ '.>■ a new pro 
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NAME 



fperr - get floating point error status 



SYNOPSIS 

fperr(&fpstat) 
int fpstat[3]; 



/* FP status register */ 
/* FP error code */ 
/* FP error address */ 



DESCRIPTION 

The fperr system call loads the contents of the floating 
point hardware status and error registers into fpstat . This 
call allows user processes to handle floating point excep- 
tions. 
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NAME 



fpsim - report or change 
lation 



the status of floating point simu- 



SYNOPSIS 

fpsim(f lag) 



DESCRIPTION 

Fpsim is used to enable, disable, or get the status of the 
kernel floating point simulator. If flag is 2, the current 
status of the simulator is returned. The return value will 
be either 0, 1, or 2, which respectively means that the 
simulator is disabled, enabled, or not configured into the 
current system. 

If l}^9 is or 1 the simulator is respectively disabled or 
enabled, and the old status of the simulator is returned 
Only the super user is allowed to change the status of the 
simulator. 

ERRORS 

f£sim will fail and the status of the simulator will remain 
unchanged if: 



SEE 



[EPERM] 

[ENODEV] 

[EINVAL] 



ALSO 
fpsim(l) 



The effective user ID of the calling 
process is not the superuser. 

The simulator is not configured into the 
current system. 

A mode other than 0, 1 or 2 was speci- 
fied. 



RESTRICTIONS 

This call is only temporary, it is intended only for use if 
the kernel floating point simulator should blow up. Once it 
has been more thoroughly tested and verified there will no 
longer be a need to be able to turn it off on a running sys- 
tem. 
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NAME 

setpgrp, getpgrp - set/get process group 

SYNOPSIS 

int getpgrp(pid) 

setpgrp(pid, pgrp) 

cc ... -Ijobs 

DESCRIPTION 

The process group of the specified process is returned by 
getpgrp . Setpgrp sets the process group of the specified 
process pid to the specified pgrp . If pid is zero, then the 
call applies to the current process. 

If the invoker is not the superuser, then the affected pro- 
cess must have the same effective user-id as the invoker or 
be a descendant of the invoking process. 

This call is used by csh (l) to create process groups in 
implementing job control. The TIOCGPGRP and TIOCSPGRP calls 
described in tty (4) are used to get/set the process group of 
the control terminal. 

See intro Qj) for a general discussion of job control. 

DIAGNOSTICS 

Setpgrp will fail and the process group will not be altered 
if one of the following is true: 

[eperm] The effective user ID of the requested pro- 
cess is different from that of the caller and 
the process is not a descendent of the cal- 
ling process. 

[ESRCH] The requested process does not exist. 

RESTRICTIONS 

The job control facilities are not available in standard 
version 7 UNIX. These facilities are still under develop- 
ment and may change in future releases of the system as 
better inter-process communication facilities and support 
for virtual terminals become available. The options and 
specifications of these system calls and even the calls 
themselves are thus subject to change. 

A system call setpgrp has been implemented in other versions 
of UNIX which are not widely used outside of Bell Labora- 
tories; these implementations have, in general, slightly 
different semantics. 
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SEE ALSO 

csh(l), getuid(2), intro(3J), tty(4) 

ASSEMBLER 

(setpgrp = 39. ) 
(process id in rO) 
sys setpgrp; newgrp 

(getpgrp is implemented as setpgrp(pid,-l) ) 
sys setgrp; -1 
(process group in rO) 
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NAME 



getpid, getppid - get process identification 



SYNOPSIS 

getpid( ) 
getppid( ) 

DESCRIPTION 

Getpid returns the process ID of the current process. Most 
often it is used to generate uniquely- named temporary files. 
Getppid returns the process ID of the parent of the current 
process. 

SEE ALSO 

mktempO) 

ASSEMBLER 

(getpid = 20. ) 
sys getpid 
(pid in rO) 
(ppid in rl) 



GETUID(2) GETUID{2) 



NAME 

getuid, getgid, geteuid, getegid - get user and group iden- 
tity 

SYNOPSIS 

getuid( ) 

geteuid( ) 

getgid( ) 

getegid( ) 

DESCRIPTION 

Getuid returns the real user ID of the current process, 
geteuid the effective user ID. The real user ID identifies 
the person who is logged in, in contradistinction to the 
effective user ID, which determines his access permission at 
the moment. It is thus useful to programs which operate 
using the 'set user ID' mode, to find out who invoked them. 

Getgid returns the real group ID, getegid the effective 
group ID. 

SEE ALSO 

setuid(2) 

ASSEMBLER 

(getuid = 24. ) 

sys getuid 

(real user ID in rO, effective user ID in rl) 

(getgid = 47. ) 

sys getgid 

(real group ID in rO, effective group ID in rl) 
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NAME 



ghostname, shostname - get/set name of current host 



SYNOPSIS 

ghostname (name, namelen) 
char *name; 
int namelen; 

shostname (name, namelen) 
char *name; 
int namelen; 



DESCRIPTION 

Ghostname returns the standard host name for the current 
processor, as previously set by shostname . The parameter 
namelen specifies the size of the name array. The returned 
name Ts null-terminated unless insufficient space is pro- 
vided. 



Shostname sets the name of the host machine to be name/ 
length namelen . This call is restricted to the 
used only when the system is 



which has 



superuser and is normally 
bootstrapped. 

RETURN VALUE 

If the call succeeds a value of is returned. If the call 
fails, then a value of -1 is returned and an error code is 
placed int the global location errno. 

ERRORS 

The following errors may be returned by these calls: 



[EFAULT] 



[EPERM] 



The name or namelen parameter gave an invalid 
address. 

The caller was not the superuser. 



RESTRICTIONS 

Host names are limited to 32 characters. 

These system calls are the same as the gethostname and 
sethostname system calls in ULTRIX-32. Due to the current 
constraint that function names must be significant in the 
first seven characters, the names were shortend to keep them 
from clashing with the (not yet implemented) gethostid and 
sethostid system calls. 

For compatibility reasons, you can use gethostname and 
sethostname in your program, provided that either the top of 
the program contains the line 

tdefine gethostname ghostname 
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or the module is compiled with 
-Dgethostname=ghostname 

as an argument to cc. This works because C£2 recognizes 
eight characters of significance. 
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NAME 

indir - indirect system call 

ASSEMBLER 

(indir = 0. ) 
sys indir; call 

The system call at the location call is executed. Execution 
resumes after the indir call. 

The main purpose of indir is to allow a program to store 
arguments in system calls and execute them out of line in 
the data segment. This preserves the purity of the text 
segment. 

If indir is executed indirectly, it is a no-op. If the 
instruction at the indirect location is not a system call, 
indir returns error code EINVAL; see intro(2). 
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NAME 

ioctl, stty, gtty - control device 

SYNOPSIS 

#include <sgtty.h> 

ioctl (fildes, request, argp) 
struct sgttyb *argp; 

stty(fildes, argp) 
struct sgttyb *argp; 

gtty{fildes, argp) 
struct sgttyb *argp; 

DESCRIPTION 

locU, performs a variety of functions on character special 
files (devices). The writeups of various devices in section 
4 discuss how ioctl applies to them. 

For certain status setting and status inquiries about termi- 
nal devices, the functions stty and gtty are equivalent to 

ioctKfildes, TIOCSETP, argp) 

ioctKf ildes, TIOCGETP, argp) 

respectively; see tty(4). 

The following two calls, however, apply to any open file: 

ioctKfildes, FIOCLEX, NULL); 
ioctKfildes, FIONCLEX, NULL); 

The first causes the file to be closed automatically during 
a successful exec operation; the second reverses the effect 
of the first. 

RETURN VALUE 

Zero is returned if the call was successful; -1 if the file 
descriptor does not refer to the kind of file for which it 
was intended. 

DIAGNOSTICS 

Ioctl will fail if one or more of the following is true: 

[EBADF] F ildes is not a valid descriptor. 

[EBADF] Carrier was lost on the terminal line. 

[EFAULT] Argp points to an illegal address. 

[ENOTTY] The specified request does not apply to the 
kind of object that the descriptor f ildes 
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references. 

[ENXIO] An attempt was made to set an invalid line 
discipline. 

[EPERM] The specified ioctlO function is only valid 
for the superuser (TIOCLOCAL, TIOCSMLB, 
TIOCCMLB). 

RESTRICTIONS 

Strictly speaking, since ioctl may be extended in different 
ways to devices with different properties, argp should have 
an open-ended declaration like 

union { struct sgttyb . . . ; ... } *argp; 

The important thing is that the size is fixed by 'struct 
sgttyb' . 

SEE ALSO 

sttyd), tty(4), exec(2) 

ASSEMBLER 

(ioctl =54.) 

sys ioctl; fildes; request; argp 

(stty = 31.) 

(file descriptor in rO) 

stty; argp 

(gtty = 32.) 

(file descriptor in rO) 

sys gtty; argp 
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NAME 

kill - send signal to a process 

SYNOPSIS 

kilKpid, sig); 

DESCRIPTION 

Kill sends the signal sig to the process specified by the 
process number in rO. See siqnal (2) for a list of signals. 

The sending and receiving processes must have the same 
effective user ID, otherwise this call is restricted to the 
superuser. 

If the process number is 0, the signal is sent to all other 
processes in the sender's process group; see tty(4) . 

If the process number is -1, and the user is the superuser 
the signal is broadcast universally except to processes 6 
and 1, the scheduler and initialization processes, see 
init ( 8 } , 

Processes may send signals to themselves. 

RETURN VALUE 

Zero is returned if the process is killed; -1 is returned 
otherwise, with errno containing the error code. 

DIAGNOSTICS 

Kill will fail and no signal will be sent if any of the fol- 
lowing occur: 



[EINVAL] 
[EINVAL] 



Sig is not a valid signal number. 

Attempt was made to send to an unassigned 
process group. 

[ESRCH] No process can be found corresponding to that 
specified by pid . 

[ESRCH] No processes killed. 

SEE ALSO 

signal(2), kill(l) 

ASSEMBLER 

(kill = 37.) 

(process number in rO) 

sys kill; sig 
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NAME 

killpg - send signal to a process or a process group 

SYNOPSIS 

killpg(pgrp, sig) 

cc . . . -Ijobs 

DESCRIPTION 

Killpg sends the signal s^a to the specified process group. 
See sigsys (2) for a list of signals; see intro Qj) for an 
explanation of process groups. 



The sending process and members of the process group 
have the same effective user ID, otherwise this call is 



must 
.s res- 
tricted to the superuser. As a single special case the con- 
tinue signal SIGCONT may be sent to any process which is a 
descendant of the current process. This allows a command 
interpreter such as csh(l) to restart set-user- id processes 
stopped from the keyboard with a stop signal. 

The calls 

killpg(0, sig) 
and 

kilKO, sig) 

have identical effects, sending the signal to all members of 
the invoker's process group (including the process itself). 
It is preferable to use the call involving kill in this 
case, as it is portable to other UNIX systems. 

RETURN VALUE 

Upon successful completion, a value of is returned. .Oth- 
erwise, a value of -1 is returned and errno is set to indi- 
cate the error. 

DIAGNOSTICS 

Killpg will fail and no signal will be sent if any of the 
following occur: 

[EINVAL] Sig is not a valid signal number. 

[EINVAL] Attempt to send to an unassigned process 
group. 

[EPERM] The caller is not the superuser. 

[ESRCH] No process can be found corresponding to the 
process group specified by pgrp . 
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[ESRCH] No processes killed. 

RESTRICTIONS 

The job control facilities are not available in standard 
Version 7 UNIX. These facilities are still under develop- 
ment and may change in future releases of the system as 
better inter-process communication facilities and support 
for virtual terminals become available. The options and 
specifications of this system call and even the call itself 
are thus subject to change. 

SEE ALSO 

cshd), kilKl), kill(2)', signal(2), sigsys(2J), introOj) 

ASSEMBLER (PDP-11) 
(kill =37.) 

(process number in rO) 
sys kill; -sig (negative signal number means killpg) 
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NAME 



link 



link to a file 



SYNOPSIS 

link(namel, name2) 
char *namel, *name2; 

DESCRIPTION 

A link to namel is created; the link has the name name2 . 
Either name may be an arbitrary path name. 

DIAGNOSTICS 

Link will fail and no link will be created if: 

[EACCES] A component of either path prefix denies 
search permission. 

[EACCES] The requested link requires writing in a 
directory with a mode that denies write per- 
mission. 

[EEXIST] A file by the same name already exists. 

[EFAULT] One of the path names specified is outside 
the process's allocated address space. 

[ENFILE] Insufficient system space to contain i-node. 

[ENOTDIR] A path prefix component is not a directory. 

[ENOENT] A path prefix component does not exist. 

[ENOENT] The file named by namel does not exist. 

[EPERM] The file named by namel is a directory and 
the effective user ID is not the superuser. 

[EROFS] The requested link requires writing in a 
directory on a read-only file system. 

[EXDEV] The link named by name 2 and the file named by 
namel are on different file systems. 

[E2BIG] The argument count exceeded "ncargs". 



SEE ALSO 

ln(l), unlink{2) 

ASSEMBLER 

(link = 9.) 

sys link; namel; name 2 
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NAME 

lock - lock a process in primary memory 

SYNOPSIS 

lock(flag) 

DESCRIPTION 

If the flag argument is non-zero, the process executing this 
call will not be swapped except if it is required to grow. 
If the argument is zero, the process is un lock ed. This call 
may only be executed by the superuser. 

DIAGNOSTICS 

Lock will fail if: 

[EPERM] The effective user ID is not the superuser. 

RESTRICTIONS 

Locked processes interfere with the compaction of primary 
memory and can cause deadlock. This system call is not con- 
sidered a permanent part of the system. 

ASSEMBLER 

(lock =53.) 
sys lock; flag 
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NAME 

Iseek, tell - move read/write pointer 

SYNOPSIS 

long lseek(f ildes, offset, whence) 
long offset; 

long telKf ildes) 

DESCRIPTION 

The file descriptor refers to a file open for reading or 
writing. The read (resp. write) pointer for the file is set 
as follows: 

If whence is 0, the pointer is set to offset bytes. 

If whence is 1, the pointer is set to its current loca- 
tion plus offset . 

If whence is 2, the pointer is set to the size of the 
file plus offset . 

The returned value is the resulting pointer location. 

The obsolete function telKf ildes ) is identical to 
lseek ( f ildes , OL, 1). 

Seeking far beyond the end of a file, then writing, creates 
a gap or 'hole', which occupies no physical space and reads 
as zeros. 

RETURN VALUE 

Upon successful completion, the new file offset is returned. 
Otherwise, a value of -1 is returned and errno is set to 
indicate the error. 

DIAGNOSTICS 

Lseek will fail and the file pointer will remain unchanged 
TT: 

[EBADF] Fildes is not an open file descriptor. 

[ESPIPE] Fildes is associated with a pipe. 

RESTRICTIONS 

Lseek is a no-op on character special files. 

SEE ALSO 

open(2), creat(2), fseek(3) 

ASSEMBLER 

(lseek =19.) 



LSEEK(2) LSEEK(2) 



(file descriptor in rO) 

sys Iseek; offsetl; offset2; whence 

Offsetl and of fset2 are the high and low words of offset ; rO 
and rl contain the pointer upon return. 
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NAME 



mknod - make a directory or a special file 



SYNOPSIS 

mknod (name, mode, addr) 
char *name; 

DESCRIPTION 

Mknod creates a new file whose name is the null-terminated 
string pointed to by name. The mode of the new file 
(including directory and special file bits) is initialized 
from mode . (The protection part of the mode is modified by 
the process's mode mask; see umask (2) ) . The first block 
pointer of the i-node is initialized from addr . For ordi- 
nary files and directories addr is normally zero. In the 
case of a special file, addr specifies which special file. 

Mknod may be invoked only by the superuser. 

RETURN VALUE 

Upon successful completion, a value of is returned. Oth- 
erwise, a value of -1 is returned and errno is set to indi- 
cate the error. 



DIAGNOSTICS 

Mknod will fail and the file mode will be unchanged if: 



[EACCES] 
[EACCES] 

[EEXIST] 
[EFAULT] 

[ENOENT] 

[ENOTDIR] 

[ENOSPC] 
[EPERM] 

[EROFS] 



Access to a directory file denied. 

A component of the path prefix denies search 
permission. 

The named file exists. 

Name points outside the process's allocated 
address space. 

A component of the path prefix does not 
exist. 

A component of the path prefix is not a 
directory. 

No i-nodes are available on the device. 

The effective user ID does not match the 
owner of the file and the effective user ID 
is not the superuser. 



The named file resides on 
system. 



a read-only file 
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SEE ALSO 

mkdir(l), mknod(l), filsys(5) 

ASSEMBLER 

(mknod = 14. ) 

sys mknod; name; mode; addr 
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NAME 

mount, umount - mount or remove file system 

SYNOPSIS 

mount (special, name, rwflag) 
char *special, *name; 

umount (special) 
char *special; 

DESCRIPTION 

Mount announces to the system that a removable file system 
has been mounted on the block-structured special file spe- 
cial ; from now on, references to file name will refer to the 
root file on the newly mounted file system. Special and 
name are pointers to null-terminated strings containing the 
appropriate path names. 

Name must exist already. Name must be a directory (unless 
the root of the mounted file system is not a directory). 
Its old contents are inaccessible while the file system is 
mounted. 

The rwflag argument determines whether the file system can 
be written on; if it is writing is allowed, if non-zero no 
writing is done. Physically write-protected and magnetic 
tape file systems must be mounted read-only or errors will 
occur when access times are updated, whether or not any 
explicit write is attempted. 

Umount announces to the system that the special file is no 
longer to contain a removable file system. The associated 
file reverts to its ordinary interpretation. 

DIAGNOSTICS 

Mount will fail if: 

[EACCES] A component of the path prefix denies search 
permission. 

[EBUSY] Name is not a directory or another process 
currently holds a reference to it. 

[EBUSY] No space remains in the mount table. 

[ENODEV] Special does not exist. 

[ENOENT] An element within name does not exist. 

[ENOTBLK] Special is not for a block oriented device. 

[ENOTDIR] a component of the path prefix in special or 
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[ENXIO] 



[EPERM] 



[ EROFS ] 



name is not a directory. 

The major device number of special is out of 
range (this indicates no device driver exists 
for the associated hardware). 

The process's effective user ID is not the 
superuser. 

Name resides on a read-only file system. 



Umount may fail with one of the following errors: 



[EBUSY] 

[EINVAL] 

[ ENODEV ] 

[ENOTBLK] 

[ENXIO] 

[EPERM] 



SEE ALSO 

mount ( 1 ) 



A process is holding a reference to a file 
located on the file system. 

The requested device is not in the mount 
table. 

Special does not exist. 

Special is not a block device. 

The major device number of special is out of 
range (this indicates no device driver exists 
for the associated hardware). 

The process's effective user ID is not the 
superuser. 



ASSEMBLER 

(mount =21.) 

sys mount; special; name; rwflag 

(umount = 22.) 

sys umount; special 
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NAME 

nice - set program priority 

SYNOPSIS 

nice(incr) 

DESCRIPTION 

The scheduling priority of the process is augmented by incr . 
Positive priorities get less service than normal. Priority 
10 is recommended to users who wish to execute long-running 
programs without flak from the administration. 

Negative increments are ignored except on behalf of the 
superuser. The priority is limited to the range -20 (most 
urgent) to 20 (least). 

The priority of a process is passed to a child process by 
fork(2). For a privileged process to return to normal 
priority from an unknown state, nice should be called suc- 
cessively with arguments -40 (goes to priority -20 because 
of truncation), 20 (to get to 0), then (to maintain compa- 
tibility with previous versions of this call). 

DIAGNOSTICS 

Nice will fail and the process's scheduling priority remain 
the same if: 

[EPERM] Incr is negative and the process's effective 
user ID is not the superuser. 

SEE ALSO 

nice(l) 

ASSEMBLER 

(nice = 34.) 
(priority in rO) 
sys nice 
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NAME 



nostk - allow process to manage its own stack 



SYNOPSIS 

nostk( ) 

DESCRIPTION 

Nostk informs the system that the process wishes to manage 
Its own stack. The system releases the stack segment(s) it 
has reserved, making them available for allocation (via 
brk( 2 ) ) by the user. 



only with great caution and 



C program should use nostk 

understanding of the C language calling and stack conven- 
tions. It is most useful for assembler programs that want 
to use the entier available address space. 

ASSEMBLER 

(nostk = 84. ) 
sys nostk 
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NAME 



open - open for reading or writing 



SYNOPSIS 

open ( name , mode ) 
char *name; 

DESCRIPTION 

Open opens the file name for reading (if mode is 0), writing 
(if mode is 1) or for both reading and writing (if mode is 
2). Name is the address of a string of ASCII characters 
representing a path name, terminated by a null character. 

The file is positioned at the beginning (byte 0). The 
returned file descriptor must be used for subsequent calls 
for other input-output functions on the file. 

DIAGNOSTICS 

The named file is opened unless one or more of the following 
is true: 



[EACCES] A component of the path prefix denies search 
permission. 

[EBUSY] The device specified is already open for 
exclusive use and the caller is not the 
superuser. 

[EFAULT] Name points outside the process's allocated 
address space. 

[EISDIR] The named file is a directory and the argu- 
ments specify it is to be opened for writing. 

[EMFILE] The maximum number of file descriptors 
allowed are already open. 

[ENFILE] No more system file descriptors are avail- 
able. 

[ENFILE] Insufficient system space to contain i-node. 

[ENOENT] The named file does not exist. 

[ENOTDIR] A component of the path prefix is not a 
directory. 

[ENXIO] Device special file is not for the current 
system (major device number is greater than 
"nchrdev", or greater than "nblkdev"). 



[ENXIO] 



An attempt was made to open /dev/tty without 
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[ENXIO] 

[EROFS] 

[ETO] 

[ETOL] 

[ETPL] 

[ETWL] 

[ETXTBSY] 



a controlling terminal. 

An illegal device was specified, or the dev- 
ice is already open. 

The named file resides on a read-only file 
system and the file is to be modified. 

The specified tape drive is already open. 

The specified tape drive is not on-line. 

Tape position was lost for the specified tape 
drive. 



The specified tape drive 
write-locked. 



is physically 



The file is a pure procedure (shared text) 
file that is being executed and the open call 
has requested write access. 



SEE ALSO 

creat(2), read(2), write(2), dup{2), close(2) 

ASSEMBLER 

(open = 5. ) 

sys open; name; mode 

(file descriptor in rO) 
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NAME 

pause - stop until signal 

SYNOPSIS 

pause ( ) 

DESCRIPTION 

Pause never returns normally. It is used to give up control 
while waiting for a signal from kill (2) or alarm (2) . 

SEE ALSO 

kilKl), kill(2), alarm(2), signal(2), setjmpO) 

ASSEMBLER 

(pause = 29.) 
sys pause 
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NAME 

phys - allow a process to access physical addresses 

SYNOPSIS 

phys(segreg, size, physadr) 

DESCRIPTION 

The argument segreg specifies a process virtual (data-space) 
address range of 8K bytes starting at virtual address 
segregxSK bytes. This address range is mapped into physical 
address physadr x64 bytes. Only the first size x64 bytes of 
this mapping is addressable. If size is zero7~any previous 
mapping of this virtual address range is nullified. For 
example, the call 

phys(6, 1, 0177775); 

will map virtual addresses 0160000-0160077 into physical 
addresses 017777500-017777577. In particular, virtual 
address 0160060 is the PDP-11 console located at physical 
address 017777560. ^ ^ 

This call may only be executed by the superuser. 

DIAGNOSTICS 

Phys will fail and the segmentation registers be unaffected 
if: 

[EINVAL] Segreg is less than or greater than 7. 

[EINVAL] Size is less than or greater than 128. 

[EINVAL] An attempt was made to map a segment which 
was already mapped by some method other than 
by phys . 

[EPERM] The process's effective user ID is not the 
superuser. 

RESTRICTIONS 

This system call is obviously very machine dependent and 
very dangerous. This system call is not considered a per- 
manent part of the system. 

SEE ALSO 

PDP-11 segmentation hardware 

ASSEMBLER 

(phys = 52. ) 

sys phys; segreg; size; physadr 
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NAME 

pipe - create an interprocess channel 

SYNOPSIS 

pipe(f ildes) 
int fildes[2]; 

DESCRIPTION 

The pipe system call creates an I/O mechanism called a pipe. 
The file descriptors returned can be used in read and write 
operations. When the pipe is written using the descriptor 
fildesCl] up to 4096 bytes of data are buffered before the 
writing process is suspended. A read using the descriptor 
f ildes LOJ will pick up the data. Writes with a count of 
4096 bytes or less are atomic; no other process can inter- 
sperse data. 

It is assumed that after the pipe has been set up, two (or 
more) cooperating processes (created by subsequent fork 
calls) will pass data through the pipe with read and write 
calls. 

The Shell has a syntax to set up a linear array of processes 
connected by pipes. 

Read calls on an empty pipe (no buffered data) with only one 
end (all write file descriptors closed) returns an end-of- 
file. A signal is generated if a write on a pipe with only 
one end is attempted. 

DIAGNOSTICS 

The pipe call will fail if: 

[EFAULT] The f ildes buffer is in an invalid area of 
the process's allocated address space. 

[EMFILE] Too many file descriptors are active. 

[ENFILE] No more system file descriptors are avail- 
able. 

[ENFILE] Insufficient system space to contain i-node. 

[ENOSPC] No more i -nodes are available on the device. 

RESTRICTIONS 

Should more than 4096 bytes be necessary in any pipe among a 
loop of processes, deadlock will occur. 

SEE ALSO 

sh(l), read(2), write(2), fork(2) 
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ASSEMBLER 

(pipe = 42.) 

sys pipe 

(read file descriptor in rO) 

(write file descriptor in rl) 
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NAME 

profil - execution time profile 

SYNOPSIS 

profiKbuff, bufsiz, offset, scale) 

char *buff; 

int bufsiz, offset, scale; 

DESCRIPTION 

Buff points to an area of core whose length (in bytes) is 
given by bufsiz . After this call, the user's program 
counter (pel is examined each clock tick (60th second); 
offset is subtracted from it, and the result multiplied by 
scale . If the resulting number corresponds to a word inside 
buff , that word is incremented. 

The scale is interpreted as an unsigned, fixed-point frac- 
tion with binary point at the left: 0177777(8) gives a 1-1 
mapping of pc's to words in buff ; 077777(8) maps each pair 
of instruction words together. 02(8) maps all instructions 
onto the beginning of buff (producing a non- interrupting 
core clock) . 

Profiling is turned off by giving a scale of or 1. It is 
rendered ineffective by giving a bufsiz of 0. Profiling is 
turned off when an exec is executed, but remains on in child 
and parent both after a fork. Profiling may be turned off 
if an update in buff would cause a memory fault. 

SEE ALSO 

monitorO), prof(l) 

ASSEMBLER 

(profil = 44.) 

sys profil; buff; bufsiz; offset; scale 
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NAME 

ptrace - process trace 

SYNOPSIS 

#include <signal.h> 

ptrace (request, pid, addr, data) 
int *addr; 

DESCRIPTION 

P^^^ace provides a means by which a parent process may con- 
trol the execution of a child process, and examine and 
change its core image. Its primary use is for the implemen- 
tation of breakpoint debugging. There are four arguments 
whose interpretation depends on a request argument. Gen- 
erally, £id is the process ID of the traced process, which 
must be a child (no more distant descendant) of the tracing 
process. A process being traced behaves normally until it 
encounters some signal whether internally generated like 
'illegal instruction' or externally generated like 'inter- 
rupt.' See siqnal (2) for the list. Then the traced process 
enters a stopped state and its parent is notified via 
waat(2). When the child is in the stopped state, its core 
image can be examined and modified using ptrace . If 
desired, another ptrace request can then cause the child 
either to terminate or to continue, possibly iqnorinq the 
signal. ^ 

The value of the request argument determines the precise 
action of the call: 

This request is the only one used by the child process; 
it declares that the process is to be traced by its 
parent. All the other arguments are ignored. Peculiar 
results will ensue if the parent does not expect to 
trace the child. 

1,2 The word in the child process's address space at addr is 
returned. If l and D space are separated, request 1 
indicates I space, 2 D space. Addr must be even. The 
child must be stopped. The input data is ignored. 

3 The word of the system's per-process data area 
corresponding to addr is returned. Addr must be even 
and less than 512. This space contains the registers 
and other information about the process; its layout 
corresponds to the user structure in the system. 

4,5 The given data is written at the word in the process's 
address space corresponding to addr , which must be even. 
No useful value is returned. If i and D space are 
separated, request 4 indicates I space, 5 D space 
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Attempts to write in pure procedure fail if another pro- 
cess is executing the same file. 

6 The process's system data is written, as it is read with 
request 3. Only a few locations can be written in this 
way: the general registers, the floating point status 
and registers, and certain bits of the processor status 
word. 

7 The data argument is taken as a signal number and the 
child's execution continues at location addr as if it 
had incurred that signal. Normally the signal number 
will be either to indicate that the signal that caused 
the stop should be ignored, or that value fetched out of 
the process's image indicating which signal caused the 
stop. If addr is (int *)1 then execution continues from 
where it stopped. 

8 The traced process terminates. 

9 Execution continues as in request 7; however, as soon as 
possible after execution of at least one instruction, 
execution stops again. The signal number from the stop 
is SIGTRAP. {On the PDP-11 the T-bit is used and just 
one instruction is executed; on the Interdata the stop 
does not take place until a store instruction is exe- 
cuted.) This is part of the mechanism for implementing 
breakpoints. 

As indicated, these calls (except for request 0) can be used 
only when the subject process has stopped. The wait call is 
used to determine when a process stops; in such a case the 
'termination' status returned by wait has the value 0177 to 
indicate stoppage rather than genuine termination. 

To forestall possible fraud, ptrace inhibits the set-user-id 
facility on subsequent exec (2) calls. If a traced process 
calls exec, it will stop before executing the first instruc- 
tion of the new image showing signal SIGTRAP. 

On the Interdata 8/32, 'word' means a 32-bit word and 'even' 
means mod 4 . 

DIAGNOSTICS 

[EFAULT] The specified address is out of bounds. 

[EPERM] The specified process cannot be traced. 

[ESRCH] The specified process does not exist. 

RESTRICTIONS 

The request call should be able to specify signals which 
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are to be treated normally and not cause a stop. In this 
way, for example, programs with simulated floating point 
(which use 'illegal instruction' signals at a very high 
rate) could be efficiently debugged. 

The error indication, -1, is a legitimate function value; 
errno , see intro (2) , can be used to disambiguate. 

It should be possible to stop a process on occurrence of a 
system call; in this way a completely controlled environment 
could be provided. 

SEE ALSO 

wait(2), signal(2), adb(l) 

ASSEMBLER 

(ptrace = 26. ) 

(data in rO) 

sys ptrace; pid; addr; request 

(value in rO) 
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NAME 

read - read from file 

SYNOPSIS 

read(fildes, buffer, nbytes) 
char *buffer; 
unsigned nbytes; 

DESCRIPTION 

A file descriptor is a word returned from a successful open , 
creat , dup , or pipe call. Buffer is the location of nbytes 
contiguous bytes into which the input will be placed. It is 
not guaranteed that all nbytes bytes will be read; for exam- 
ple if the file refers to a typewriter at most one line will 
be returned. In any event the number of characters read is 
returned. 

If the returned value is 0, then end-of-file has been 
reached. 

DIAGNOSTICS 

Read will fail if one or more of the following is true: 

Cebadf] Fildes is not a valid file descriptor open 
for reading. 

[EFAULT] Buf points outside the process's allocated 
address space. 

[EFAULT] The specified address is either odd or out of 
range when dealing with character special 
files. 

[EINTR] A read from a slow device was interrupted 
(before any data arrived) by the delivery of 
a signal. 

[ENXIO] The /dev/mem address specified is illegal. 

[ETPL] The magtape tape position was lost or the 
tape unit went offline during a read. 

[EWOULDBLOCK] The process would hang waiting for input 
(when mode is set to interrupt on each char- 
acter input). 

SEE ALSO 

open(2), creat(2), dup(2), pipe(2) 

ASSEMBLER 

(read =3.) 

(file descriptor in rO) 
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sys read; buffer; nbytes 
(byte count in rO) 
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NAME 

renice - set program priority 

SYNOPSIS 

renice(pid,nice) 

DESCRIPTION 

Renice sets the scheduling priority of the process with id 
pid to nice . The superuser may renice any process to any 
value from -127 to 127. Other users may only increase the 
nice value of one of their own processes. 

DIAGNOSTICS 

Renice will fail and the process's scheduling priority will 
be unaltered if: 

[EPERM] The named process's effective user ID is not 
the same as the calling process and the 
process's effective user ID is not the 
superuser. 

[ESRCH] The named process does not exist. 

SEE ALSO 

nice(l), renice(l), nice(2) 

ASSEMBLER 

(renice = 87.) 

sys renice; pid; nice 

(old nice value in rO) 
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NAME 

setpgrp, getpgrp - set/get process group 

SYNOPSIS 

int getpgrp(pid) 

setpgrp(pid, pgrp) 

cc ... -Ijobs 

DESCRIPTION 

The process group of the specified process is returned by 
getpgrp . Setpgrp sets the process group of the specified 
process pid to the specified pgrp . If pid is zero, then the 
call applies to the current process. 

If the invoker is not the superuser, then the affected pro- 
cess must have the same effective user- id as the invoker or 
be a descendant of the invoking process. 

This call is used by csh(l) to create process groups in 
implementing job control. The TIOCGPGRP and TIOCSPGRP calls 
described in tty (4) are used to get/set the process group of 
the control terminal. 

See intro Qj) for a general discussion of job control. 

DIAGNOSTICS 

Setpgrp will fail and the process group will not be altered 
if one of the following is true: 

[EPERM] The effective user ID of the requested pro- 
cess is different from that of the caller and 
the process is not a descendent of the cal- 
ling process. 

[ESRCH] The requested process does not exist. 

RESTRICTIONS 

The job control facilities are not available in standard 
version 7 UNIX. These facilities are still under develop- 
ment and may change in future releases of the system as 
better inter-process communication facilities and support 
for virtual terminals become available. The options and 
specifications of these system calls and even the calls 
themselves are thus subject to change. 

A system call setpgrp has been implemented in other versions 
of UNIX which are not widely used outside of Bell Labora- 
tories; these implementations have, in general, slightly 
different semantics. 
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SEE ALSO 

csh(l), getuid(2), intro(3J), tty(4) 

ASSEMBLER 

(setpgrp = 39. ) 
(process id in rO) 
sys setpgrp; newgrp 

(getpgrp is implemented as setpgrp(pid,-l) ) 
sys setgrp; -1 
(process group in rO) 



SETUID(2) SETUID(2) 



NAME 

setuid, setgid - set user and group ID 

SYNOPSIS 

setuid(uid) 

setgid(gid) 

DESCRIPTION 

The user ID (group ID) of the current process is set to the 
argument. Both the effective and the real ID are set. 
These calls are only permitted to the superuser or if the 
argument is the real ID. 

DIAGNOSTICS 

Setuid will fail and the user ID will be unchanged if: 

[EPERM] A non-superuser attempt is made to change the 
effective user ID to anything other than the 
real user ID. 

Setgid will fail and the group ID will be unchanged if: 

[EPERM] A non-superuser attempt is made to change the 
effective group ID to anything other than the 
real group ID. 

SEE ALSO 

getuid(2) 

ASSEMBLER 

(setuid = 23.) 
(user ID in rO) 
sys setuid 

(setgid = 46. ) 
(group ID in rO) 
sys setgid 
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NAME 

signal - catch or ignore signals 

SYNOPSIS 

#include <signal.h> 

(*signal(sig, func))() 
(*func)(); 

DESCRIPTION 

A signal is generated by some abnormal event, initiated 
either by user at a typewriter (quit, interrupt), by a pro- 
gram error (bus error, etc.), or by request of another pro- 
gram (kill). Normally all signals cause termination of the 
receiving process, but a signal call allows them either to 
be ignored or to cause an interrupt to a specified location. 
Here is the list of signals with names as in the include 
file. 

SIGHUP 1 hangup 

SIGINT 2 interrupt 

SIGQUIT 3* quit 

SIGILL 4* illegal instruction (not reset when caught) 

SIGTRAP 5* trace trap (not reset when caught) 

SIGIOT 6* lOT instruction 

SIGEMT 7* EMT instruction 

SIGFPE 8* floating point exception 

SIGKILL 9 kill (cannot be caught or ignored) 

SIGBUS 10* bus error 

SIGSEGV 11* segmentation violation 

SIGSYS 12* bad argument to system call 

SIGPIPE 13 write on a pipe or link with no one to read it 

SIGALRM 14 alarm clock 

SIGTERM 15 software termination signal 

16 unassigned 

The starred signals in the list above cause a core image if 
not caught or ignored. 

If func is SIG_DFL, the default action for signal si^ is 
reinstated; this default is termination, sometimes with a 
core image. If func is SIG_IGN the signal is ignored. Oth- 
erwise when the signal occurs func will be called with the 
signal number as argument. A return from the function will 
continue the process at the point it was interrupted. 
Except as indicated, a signal is reset to SIG_DFL after 
being caught. Thus if it is desired to catch every such 
signal, the catching routine must issue another signal call. 

When a caught signal occurs during certain system calls, the 
call terminates prematurely. In particular this can occur 
during a read or write (2) on a slow device (like a 
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typewriter; but not a file); and during pause or wart (2). 
When such a signal occurs, the saved user status is arranged 
in such a way that when return from the signal-catching 
takes place, it will appear that the system call returned an 
error status. The user's program may then, if it wishes, 
re-execute the call. 

The value of signal is the previous (or initial) value of 
func for the particular signal. 

After a fork(2) the child inherits all signals. Exec (2) 
resets all caught signals to default action. 

DIAGNOSTICS 

Signal will fail if: 

[EINVAL] Sig is an illegal signal number, including 
SIGKILL. 

RESTRICTIONS 

If a repeated signal arrives before the last one can be 
reset, there is no chance to catch it. 

The type specification of the routine and its func argument 
are problematical. 

SEE ALSO 

kilKl), kill(2), ptrace(2), sigsys(2J), setjmpO), 
sigset(3J) 

ASSEMBLER 

(signal = 48.) 

sys signal; sig; label 

(old label in rO) 

If label is 0, default action is reinstated. If label is 
odd, the signal is ignored. Any other even label specifies 
an address in the process where an interrupt is simulated. 
An RTI or RTT instruction will return from the interrupt. 
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NAME 

sigsys - catch or ignore signals 

SYNOPSIS 

finclude <signal.h> 

(*sigsys(sig, func))() 

void (*func)(); 

int (*func)(); (if_ void is not supported ) 

cc ... -Ijobs 

DESCRIPTION 

N.B.: The system currently supports two signal implementa- 
tions. The one described in signal (2) is standard in ver- 
sion 7 UNIX systems, and retained for backward compatibility 
as it is different in a number of ways. The one described 
here (with the interface in sigset Qj)) provides for the 
needs of the job control mechanisms (see intro Qj) ) used by 
csh(l), and corrects the bugs in the standard implementation 
of signals, allowing programs which process interrupts to be 
written reliably. 

The routine sigsys is not normally called directly; rather 
the routines of sigset Qj) should be used. These routines 
are kept in the 'jobs' library, accessible by giving the 
loader option -Ijobs. The features described here are less 
portable then those of signal (2) and should not be used in 
programs which are to be moved to other versions of UNIX. 

A signal is generated by some abnormal event, initiated by a 
user at a terminal (quit, interrupt, stop), by a program 
error (bus error, etc.), by request of another program 
(kill), or when a process is stopped because it wishes to 
access its control terminal while in the background (see 
tty (4) ) . Signals are optionally generated when a process 
resximes after being stopped, when the status of child 
processes changes, or when input is ready at the control 
terminal. Most signals cause termination of the receiving 
process if no action is taken; some signals instead cause 
the process receiving them to be stopped, or are simply dis- 
carded if the process has not requested otherwise. Except 
for the SIGKILL and SIGSTOP signals which cannot be blocked, 
the sigsys call allows signals either to be ignored, held 
until a later time (protecting critical sections in the pro- 
cess), or to cause an interrupt to a specified location. 
Here is the list of all signals with names as in the include 
file. 

SIGHUP 1 hangup 
SIGINT 2 interrupt 
SIGQUIT 3* quit 
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SIGILL 


4* 


SIGTRAP 


5* 


SIGIOT 


6* 


SIGEMT 


7* 


SIGFPE 


8* 


SIGKILL 


9 


SIGBUS 


10* 


SIGSEGV 


11* 


SIGSYS 


12* 


SIGPIPE 


13 


SIGALRM 


14 


SIGTERM 


15 




16 


SIGSTOP 


17 + 


SIGTSTP 


18 + 


SIGCONT 


19o 


SIGCHLD 


20o 


SIGTTIN 


21+ 


SIGTTOU 


22 + 


SIGTINT 


23o 


SIGXCPU 


24 


SIGXFSZ 


25 



illegal instruction (not reset when caught) 

trace trap (not reset when caught) 

lOT instruction 

EMT instruction 

floating point exception 

kill (cannot be caught, held or ignored) 

bus error 

segmentation violation 

bad argument to system call 

write on a pipe with no one to read it 

alarm clock 

software termination signal 

unassigned 

stop (cannot be caught, held or ignored) 

stop signal generated from keyboard 

continue after stop 

child status has changed 

background read attempted from control terminal 

background write attempted to control terminal 

input record is available at control terminal 

cpu time limit exceeded (see vlimit (2) ) 

(VAX- 11 only) 
file size limit exceeded (see vlimit (2) ) 

(VAX-11 only) 



The starred signals in the list above cause a core image 
not caught, held or ignored. 



if 



If func is SIG_DFL, the default action for signal sig is 
reinstated; this default is termination (with a core image 
for starred signals) except for signals marked with o or +. 
Signals marked with o are discarded if the action is 
SIG_DFL; signals marked with + cause the process to stop. 
If func is SIG_HOLD the signal is remembered if it occurs, 
but not presented to the process; it may be presented later 
if the process changes the action for the signal. If func 
is SIG_IGN the signal is subsequently ignored, and pending 
instances of the signal are discarded (i.e. if the action 
was previously SIG_HOLD.) Otherwise when the signal occurs 
func will be called. 



A return from the function will continue the process at the 
point it was interrupted. Except as indicated, a signal, 
set with sigsys , is reset to SIG_DFL after being caught. 
However by specifying DEFERS IG( func) as the last argument to 
sigsys , one causes the action to be set to SIG_HOLD before 
the interrupt is taken, so that recursive instances of the 
signal cannot occur during handling of the signal. 

When a caught signal occurs during certain system calls, the 
call terminates prematurely. In particular this can occur 
during a read or write (2) on a slow device (like a terminal; 
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but not a file) and during a pause or wait (2) . When a sig- 
nal occurs during one of these calls, the saved user status 
is arranged in such a way that, when return from the 
signal-catching takes place, it will appear that the system 
call returned an error status. The user's program may then, 
if it wishes, re-execute the call. Read and write calls 
which have done no I/O, ioctl s blocked with SIGTTOU, and 
wait2 or wait 3 calls are restarted. 

The value of sigsys is the previous (or initial) value of 
func for the particular signal. 

The system provides two other functions by oring bits into 
the signal number: SIGDOPAUSE causes the process to pause 
after changing the signal action. It can be used to atomi- 
cally re-enable a held signal which was being processed and 
wait for another instance of the signal. SIGDORTI causes 
the system to simulate an rei instruction clearing the mark 
the system placed on the stack at the point of interrupt 
before checking for further signals to be presented due to 
the specified change in signal actions. This allows a sig- 
nal package such as sigset Qj) to dismiss from interrupts 
cleanly removing the old state from the stack before another 
instance of the interrupt is presented. 

After a fork(2) or vfork(2) the child inherits all signals. 
Exec (2) resets all caught signals to default action; held 
signals remain held and ignored signals remain ignored. 

RETURN VALUE 

The value BADSIG is returned if the given signal is out of 
range. 

DIAGNOSTICS 

Sigsys will fail if: 

[EINVAL] Sig is an illegal signal number, including 
SIGKILL and SIGSTOP. 

RESTRICTIONS 

The job control facilities are not available in standard 
version 7 UNIX. These facilities are still under develop- 
ment and may change in future releases of the system as 
better inter-process communication facilities and support 
for virtual terminals become available. The options and 
specifications of this facility and the system calls sup- 
porting it are thus subject to change. 

Since only one signal action can be changed at a time, it is 
not possible to get the effect of SIGDOPAUSE for more than 
one signal at a time. 
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The traps (listed below) should be distinguishable by extra 
arguments to the signal handler, and all hardware supplied 
parameters should be made available to the signal routine. 



SEE ALSO 

kilKl), kill(2), 
setjmpO), tty(4) 



ptrace(2), intro(3J) 



sigset(3J) , 



ASSEMBLER (PDP-11) 
(signal = 48.) 
sys signal; sig; label 
(old label in rO) 

If label is 0, default act 
the signal is ignored. 
Any other even label speci 
where an interrupt is simu 
the signal is sent to the 
label with the low bit 
SIG_HOLD. (Thus DEFERS I G 
signal catch address. An 
from the interrupt.) 



ion is reinstated. If label is 1, 
If label is 3, the signal is held, 
fies an address in the process 
lated. If label is otherwise odd, 
function whose address is the 
cleared with the action set to 
is indicated by the low bit of a 
RTI or RTT instruction will return 



NOTES (VAX- 11) 

The handler routine can be declared: 

handler(signo, param, xx, pc, psl) 

Here signo is the signal name, into which the hardware 
faults and traps are mapped as defined below. Param is the 
parameter which is either a constant as given below or, for 
compatibility mode faults, the code provided by the 
hardware. Compatibility mode faults are distinguished from 
the other SIGILL traps by having PSL_CM set in the psl. 

The routine is actually called with only 3 parameters speci- 
fied in the calls or callq instruction. After return from 
the signal handler the ^c and psl are popped off of the 
stack with an rei , so they act as 'value-result' parameters 
unlike normal C value parameters. 

The following defines the mapping of hardware traps to sig- 
nals and codes. All of these symbols are defined in 
<signal.h>: 



Hardware condition 

Arithmetic traps: 
Integer overflow 
Integer division by zero 
Floating overflow trap 
Floating/decimal division 



Signal Code 



SIGFPE FPE_INTOVF_TRAP 

SIGFPE FPE_INTDIV_TRAP 

SIGFPE FPE_FLTOVF_TRAP 

SIGFPE FPE FLTDIV TRAP 
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by zero 

Floating underflow trap 
Decimal overflow trap 
Subscr ipt-range 
Floating overflow fault 
Floating divide by zero fault 
Floating underflow fault 

Length access control 

Protection violation 

Reserved instruction 

Customer-reserved instr. 

Reserved operand 

Reserved addressing 

Trace pending 

Bpt instruction 

Compat ibi 1 i ty-mode 

Chme 
Chms 
Chmu 



SIGFPE 


FPE FLTUND TRAP 


SIGFPE 


FPE DECOVF TRAP 


SIGFPE 


FPE SUBRNG TRAP 


SIGFPE 


FPE FLTOVF FAULT 


SIGFPE 


FPE FLTDIV FAULT 


SIGFPE 


FPE_FLTUND_FAULT 


SIGSEGV 




SIGBUS 




SIGILL 


ILL_RESAD_FAULT 


SIGEMT 




SIGILL 


ILL PRIVIN FAULT 


SIGILL 


ILL_RESOP_FAULT 


SIGTRAP 




SIGTRAP 




SIGILL 


hardware supplied 




code 


SIGSEGV 




SIGSEGV 




SIGSEGV 
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NAME 



Stat, fstat - get file status 



SYNOPSIS 

# include <sys/types.h> 
# include <sys/stat.h> 

Stat (name, buf) 
char *name; 
struct Stat *buf; 

fstat(f ildes, buf) 
struct Stat *buf; 

DESCRIPTION 

Stat obtains detailed information about a named file. Fstat 
obtains the same information about an open file known by the 
file descriptor from a successful open , creat, dup or 
pipe (2) call. 

Name points to a null-terminated string naming a file; buf 
is the address of a buffer into which information is placed 
concerning the file. It is unnecessary to have any permis- 
sions at all with respect to the file, but all directories 
leading to the file must be searchable. The layout of the 
structure pointed to by buf as defined in <stat.h> is given 
below. St mode is encoded according to the '#defTne' state- 
ments. 



/* 
* 

St 

{ 



SCCSID: @(#)stat.h 
/ 
ruct Stat 



1.0 11/12/83 



}; 



dev_t 

ino t 

unsigned 

short 

short 

short 

dev_t 

off_t 

t ime_t 

t ime_t 

time t 



st_dev; 

st_ino; 

short st_mode; 

st_nlink; 

st_uid; 

st_gid; 

st_rdev; 

st_size; 

st_atime; 

st_mtime; 

St ctime; 



#def ine 
#def ine 
#def ine 
#def ine 
#def ine 



S_IFMT 
S_IFDIR 
S_IFCHR 
S_IFBLK 
S IFREG 



0170000 
0040000 
0020000 
0060000 
0100000 



/* 
/* 
/* 
/* 
/* 



type of file */ 
directory */ 
character special 
block special */ 
regular */ 



V 
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#def ine 
#def ine 
#def ine 
#def ine 
#def ine 

#def ine 
#def ine 
#def ine 



S_IFMPC 
S_IFMPB 
S_ISUID 
S_ISGID 
S_ISVTX 

S_IREAD 
S_I WRITE 
S I EXEC 



0030000 
0070000 
0004000 
0002000 
0001000 

after use 
0000400 
0000200 / 
0000100 

owner */ 



/* multiplexed char special */ 
/* multiplexed block special */ 
/* set user id on execution */ 
/* set group id on execution */ 
/* save swapped text even 
*/ 

/* read permission, owner */ 
* write permission, owner */ 
/* execute/search permission, 



The mode bits 0000070 and 0000007 encode group and others 
permissions (see chmod (2) ) . The defined types, ino t , 
off t , time t , name various width integer values; dev t 
encodes major and minor device numbers; their exact def ini- 
tions are in the include file <sys/types.h> (see types (5) . 

When f ildes is associated with a pipe, fstat reports an 
ordinary file with restricted permissions. The size is the 
number of bytes queued in the pipe. 

St atime is the file was last read. For reasons of effi- 
ciency, it is not set when a directory is searched, although 
this would be more logical, st mtime is the time the file 
was last written or created^ It is not set by changes of 
owner, group, link count, or mode, st ctime is set both by 
writing and changing the i-node. 

DIAGNOSTICS 

Stat will fail if one or more of the following is true: 



[EACCES] 

[ EFAULT ] 
[ENFILE] 
[ ENOENT ] 

[ENOTDIR] 



Search permission is denied for a component 
of the path prefix. 

Name or buf points to an invalid address. 

Insufficient system space to contain i-node. 

The named file, or an element within the 
named file, does not exist. 

A component of the path prefix is not a 
directory. 



Fstat will fail if one or both of the following is true: 
[EBADF] Fildes is not a valid open file descriptor, 



[EFAULT] 



Buf points to an address outside of the 
process's allocated address space. 
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SEE ALSO 

ls(l), filsys(5) 

ASSEMBLER 

(stat = 18.) 

sys Stat; name; buf 



(fstat =28.) 

(file descriptor in rO) 

sys fstat; buf 
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NAME 

stime - set time 

SYNOPSIS 

stime(tp) 
long *tp; 

DESCRIPTION 

Stime sets the system's idea of the time and date. Time, 
pointed to by t£, is measured in seconds from 0000 GMT Jan 
1, 1970. Only the superuser may use this call. 

DIAGNOSTICS 

Stime will fail and the system's current time will be 
unchanged if: 

[EPERM] The process's effective user ID is not the 
superuser. 

SEE ALSO 

date ( 1 ) , t ime ( 2 ) , ct ime ( 3 ) 

ASSEMBLER 

(stime = 25. ) 
(time in rO-rl) 
sys stime 
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NAME 

sync - update super-block 

SYNOPSIS 

sync( ) 

DESCRIPTION 

Sync causes all information in core memory that should be on 
disk to be written out. This includes modified super 
blocks, modified i-nodes, and delayed block I/O. 

It should be used by programs which examine a file system, 
for example icheck , df, etc. It is mandatory before a boot. 

SEE ALSO 

sync(l), update(8) 

RESTRICTIONS 

The writing, although scheduled, is not necessarily complete 
upon return from sync . 

ASSEMBLER 

(sync = 36.) 
sys sync 
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NAME 

time, ftime - get date and time 

SYNOPSIS 

long time(O) 

long time(tloc) 
long *tloc; 

# include <sys/types.h> 

# include <sys/timeb.h> 

ftime(tp) 

struct timeb *tp; 

DESCRIPTION 

Time returns the time since 00:00:00 GMT, Jan. 1, 1970, 
measured in seconds. 

If tloc is nonnull, the return value is also stored in the 
place to which tloc points. 

The ftime entry fills in a structure pointed to by its argu- 
ment, as defined by < sys / timeb .h>: 

/* 

* SCCSID: @(#)timeb. hi. 011/12/83 
*/ 

/* 

* Structure returned by ftime system call 
*/ 

struct timeb { 

time_t time; 

unsigned short millitm; 

short timezone; 

short dstflag; 
}; 

The structure contains the time since the epoch in seconds, 
up to 1000 milliseconds of more-precise interval, the local 
timezone (measured in minutes of time westward from 
Greenwich), and a flag that, if nonzero, indicates that Day- 
light Saving time applies locally during the appropriate 
part of the year. 

DIAGNOSTICS 

Ftime will fail if: 

[EFAULT] T^ points to an address outside the process's 
allocated address space. 

SEE ALSO 

dated), stime(2), ctimeO) 
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ASSEMBLER 

(ftime = 35.) 
sys ftime; bufptr 



(time = 13.; obsolete call) 

sys time 

(time since 1970 in rO-rl) 
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NAME 

times - get process times 

SYNOPSIS 

times(buf fer) 

struct tbuffer *buffer; 

DESCRIPTION 

Times returns time-accounting information for the current 
process and for the terminated child processes of the 
current process. All times are in 1/HZ seconds, where HZ=60 
in North America. 

After the call, the buffer will appear as follows: 

struct tbuffer { 

long proc_user_time; 
long proc_system_time; 
long child_user_time; 
long child_system_time; 

}; 

The children times are the sum of the children's process 
times and their children's times. 

SEE ALSO 

timed), time(2) 

ASSEMBLER 

(times = 43.) 
sys times; buffer 
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NAME 

iimask - set file creation mode mask 

SYNOPSIS 

umask ( complmode ) 

DESCRIPTION 

Umask sets a mask used whenever a file is created by 
creat (2) or mknod(2): the actual mode (see chmod (2) ) of the 
newly-created file is the logical and of the given mode and 
the complement of the argument. Only the low-order 9 bits 
of the mask (the protection bits) participate. In other 
words, the mask shows the bits to be turned off when files 
are created. 

The previous value of the mask is returned by the call. The 
value is initially (no restrictions). The mask is inher- 
ited by child processes. 

SEE ALSO 

creat(2), mknod(2), chmod(2) 

ASSEMBLER 

(limask = 60.) 

sys xomask; complmode 



UNLINK(2) 



UNLINK(2) 



NAME 



unlink - remove directory entry 



SYNOPSIS 

unlink (name) 
char *name; 

DESCRIPTION 

Name points to a null-terminated string. Unlink removes the 
entry for the file pointed to by name from its directory. 
If this entry was the last link to the file, the contents of 
the file are freed and the file is destroyed. If, however, 
the file was open in any process, the actual destruction is 
delayed until it is closed, even though the directory entry 
has disappeared. 

DIAGNOSTICS 

The unlink will succeed unless: 



[EACCES] 

[EACCES] 

[EBUSY] 

[EFAULT] 

[ENFILE] 
[ ENOENT ] 

[ENOTDIR] 

[EPERM] 

[EROFS] 
[ETXTBSY] 



SEE ALSO 

rm(l), link{2) 



Search permission is denied for a component 
of the path prefix. 

Write permission is denied on the directory 
containing the link to be removed. 

The entry to be unlinked is the mount point 
for a mounted file system. 



Name points to an address outside 
process's allocated address space. 



the 



Insufficient system space to contain i-node. 

The named file, or an element within the 
named file, does not exist. 

A component of the path prefix is not a 
directory. 

The named file is a directory and the 
process's effective user ID is not the 
superuser. 

The named file resides on a read-only file 
system. 

The file is a pure procedure (shared text) 
file that is currently open for reading or 
writing by some process. 
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ASSEMBLER 

(unlink = 10.) 
sys unlink; name 
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NAME 



utime - set file times 



SYNOPSIS 

# include <sys/types.h> 
utinie(file, timep) 
char *file; 
time_t timep[2]; 

DESCRIPTION 

The utime call uses the 'accessed' and 'updated' times in 
that order from the timep vector to set the corresponding 
recorded times for file . 

The caller must be the owner of the file or the superuser. 
The ' inode-changed' time of the file is set to the current 
time. 

DIAGNOSTICS 

Utime will fail if one or more of the following is true: 



[EACCES] 

[EFAULT] 

[ENFILE] 
[ENOENT] 

[ENOTDIR] 

[EPERM] 

[EROFS] 



SEE ALSO 

Stat (2) 



A component of the path prefix denies search 
permission. 

Timep points to an address outside the 
process's allocated address space. 

Insufficient system space to contain i-node. 

The named file, or an element within the 
named file, does not exist. 

A component of the path prefix is not a 
directory. 

The process's effective user ID is not the 
superuser and not the same as the owner of 
the file. 

The named file is located on a read-only file 
system. 



ASSEMBLER 

(utime = 30.) 

sys utime; file; timep 
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NAME 



wait - wait for process to terminate 



SYNOPSIS 

wait(status) 
int *status; 

wait(O) 

DESCRIPTION 

Wait causes its caller to delay until a signal is received 
or one of its child processes terminates. If any child has 
died since the last wait, return is immediate; if there are 
no children, return is immediate with the error bit set 
(resp. with a value of -1 returned). The normal return 
yields the process ID of the terminated child. In the case 
of several children several wait calls are needed to learn 
of all the deaths. 

If (int)status is nonzero, the high byte of the word pointed 
to receives the low byte of the argument of exit when the 
child terminated. The low byte receives the termination 
status of the process. See signal (2) for a list of termina- 
tion statuses (signals); status indicates normal termina- 
tion. A special status (0177) is returned for a stopped 
process which has not terminated and can be restarted. See 
ptrace (2) . If the 0200 bit of the termination status is 
set, a core image of the process was produced by the system. 

If the parent process terminates without waiting on its 
children, the initialization process (process ID = 1) inher- 
its the children. 

RETURN VALUE 

If wait returns due to the receipt of a signal, a value of 
-1 IS returned to the calling process and the errno is set 
to EINTR. If wait returns due to a stopped or terminated 
child process, the process ID of the child is returned to 
the calling process. Otherwise, a value of -1 is returned 
and errno is set to indicate the error. 

DIAGNOSTICS 

Wait will fail and return immediately if the following is 
true: 



[ECHILD] The calling process has no unwaited-for child 
processes. 

[EFAULT] The status argument points to an address out- 
side of the process's allocated address 
space. 
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SEE ALSO 

exit(2), fork(2), signal(2) 

ASSEMBLER 

(wait = 7.) 
sys wait 

(process ID in rO) 
(status in rl) 

The high byte of the status is the low byte of rO in the 
child at termination. 
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NAME 

wait2 - wait for process to terminate 

SYNOPSIS 

# include <wait.h> 

wait2(ScW.w_status, options) 
union wait w; 
int options; 

cc ... -Ijobs 

DESCRIPTION 

Wait2 is similar to the standard wait (2) system call, but 
allow additional options useful with job control. They 
return the process ID of a terminated or stopped child pro- 
cess. The w. w status and option words are described by 
definitions and macros in the file <wait.h>; the union and 
its bitfield definitions and associated macros given there 
provide convenient and mnemonic access to the word of status 
returned by a wait2 call. If the call returns a process ID, 
several macros are available to interpret the status word 
returned. If the process is stopped, WIFSTOPPED(w) is true, 
and the signal that caused it to stop is w.w_stopsig. If 
the process is not stopped (has terminated), WIFEXITED(w) 
determines whether it terminated by calling exit(2); if so, 
the exit code is w.w_retcode. WIFSIGNALED(w) is true if the 
process was terminated by a signal (see signal (2) ) ; the sig- 
nal causing termination was w.w_termsig, and w.w_coredump 
indicates whether a core dximp was produced. 

There are two options , which may be combined by oring them 
together. The first is WNOHANG which causes the wait2 to 
not hang if there are no processes which wish to report 
status, rather returning a pid of in this case as the 
result of the wait2. The second option is WUNTRACED which 
causes wait2 to return information when children of the 
current process which are stopped but not traced (with 
ptrace (2) ) because they received a SIGTTIN, SIGTTOU, SIGTSTP 
or SIGSTOP signal. See sigsys (2J) for a description of 
these signals. 

RETURN VALUE 

Returns -1 if there are no children not previously waited 
for, or if the WNOHANG option is given and there are no 
stopped or exited children. 

DIAGNOSTICS 

Wait2 will fail and return immediately if one or more of the 
following is true: 

[ECHILD] The calling process has no unwaited-for child 
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[EFAULT] 



processes. 

The w.w_status argxoment points to an address 
outside the process's allocated address 
space. 



RESTRICTIONS 

This call is peculiar to this version of UNIX. The options 

and specifications of this system call and even the call 

itself are subject to change. It may be replaced by other 

facilities in future versions of the system. 

SEE ALSO 

exit(2), fork(2), sigsys(2J), wait(2) 
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NAME 



write - write on a file 



SYNOPSIS 

write{f ildes, buffer, nbytes) 
char *buffer; 

DESCRIPTION 

A file descriptor is a word returned from a successful open , 
creat , dug, or pipe (2) call. 

Buffer is the address of nbytes contiguous bytes which are 
written on the output file. The number of characters actu- 
ally written is returned. It should be regarded as an error 
if this is not the same as requested. 

Writes which are multiples of 512 characters long and begin 
on a 512-byte boundary in the file are more efficient than 
any others. 

DIAGNOSTICS 

Write will fail if one or more of the following is true: 



[EBADF] 
[EFAULT] 

[EFAULT] 

[EFBIG] 

[ENXIO] 
[EPIPE] 

[EQUOT] 

[ETPL] 



Fildes is not a valid descriptor open for 
writing. 

The specified address is odd or the count is 
odd when dealing with disk character special 
files. 

The buffer points to an address outside the 
process's allocated address space. 



An attempt was made to write a 
exceeds the maximum file size. 



file that 



The specified /dev/mem address is illegal. 

An attempt is made to write to a pipe that is 
not open for reading by any process. 

An attempt was made to write a file that 
exceeds a quota governing the file. 

The magtape tape position was lost or the 
tape went offline during a write. 



SEE ALSO 

creat (2), open(2), pipe(2) 



ASSEMBLER 

(write = 4. ) 
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(file descriptor in rO) 
sys write; buffer; nbytes 
(byte count in rO) 
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NAME 

zaptty - zap the controlling tty 

SYNOPSIS 

zaptty( ) 

DESCRIPTION 

Zaptty will disassociates a process from it's controlling 
tty. The next terminal type device that the process opens 
will become the new controlling tty. Zaptty is useful for 
daemons, since they usually do not want to be associated 
with any terminal. 

For obvious reasons, this call is restricted to the 
superuser. 

ASSEMBLER 

(zaptty =69.) 
sys zaptty 
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NAME 

intro - introduction to library functions 

SYNOPSIS 

#include <stdio.h> 

# include <math.h> 

DESCRIPTION . ^ • 

This section describes functions that may be found in vari- 
ous libraries, other than those functions that directly 
invoke UNIX system primitives, which are described in sec- 
tion 2. Functions are divided into various libraries dis- 
tinguished by the section number at the top of the page: 

(3) These functions, together with those of section 2 and 
those marked (3S), constitute librarys libc and lib- 
cov, which is automatically loaded by the C compiler 
^^1) and the Fortran compiler f77(l). The link edi- 
tor ld(l) searches this library under the '-Ic' or 
•-Icov' option. Declarations for some of these func- 
tions may be obtained from include files indicated on 
the appropriate pages. 

(3M) These functions constitute the math library, libm. 
They are automatically loaded as needed by the Fortran 
compiler f77(l). The link editor searches this 
library under the '-Im' option. Declarations for 
these functions may be obtained from the include file 
<math.h>. 

(3S) These functions constitute the 'standard I/O package', 
see stdio (3) . These functions are in the librarys 
libc and libcov already mentioned. Declarations for 
these functions may be obtained from the include Hile 
<stdio.h>. 

{3X) Various specialized libraries have not been given dis- 
tinctive captions. The files in which these libraries 
are found are named on the appropriate pages. 

FILES 

/lib/libc.a 

/lib/libcov.a 

/lib/libm.a, /usr/lib/libm.a (one or the other) 

SEE ALSO 

stdio(3), nm(l), ld(l), cc(l), f77{l), intro(2) 

DIAGNOSTICS 

Functions in the math library (3M) may return conventional 
values when the function is undefined for the given 
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arguments or when the value is not representable. In these 
cases the external variable errno (see intro(2)) is set to 
the value EDOM or ERANGE. The values of EDOFTand ERANGE are 
defined in the include file <math.h>. 

ASSEMBLER 

In assembly language these functions may be accessed by 

simulating the C calling sequence. For example, ecvtO) 

might be called this way: _v^v_lvo/ 

setd 

mov $sign,-(sp) 

mov $decpt,-(sp) 

mov ndigit,-(sp) 

movf value, -(sp) 

jsr pc,_ecvt 

add $14., sp 
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NAME , ^ . - , ^ . 

intro - summary of job control facilities 

SYNOPSIS 

#include <sys/ioctl.h> 
#include <signal.h> 
tinclude <wait.h> 

int fildes, signo; 
short pid, pgrp; 
union wait status; 

ioctKfildes, TIOCSPGRP, &pgrp) 
ioctK fildes, TIOCGPGRP, &pgrp) 

sigset(signo, action) 
sighold(signo) 
sigrelse(signo) 
sigpause(signo) 
sigsys(signo, action) 

wait2(&status, options) 

cc . . . -Ijobs 

DESCRIPTION ^ ^ ., „ .^^ 

The facilities described here are used to support the 30b 
control implemented in csh(l), and may be used in other pro- 
grams to provide similar facilities. Because these facili- 
ties are not standard in UNIX and because the signal mechan- 
isms are also slightly different, the associated routines 
are not in the standard C library, but rather in the -l^obs 
library. 

For descriptions of the individual routines see the various 
sections listed in SEE ALSO below. This section attempt 
only to place these facilities in context, not to explain 
the semantics of the individual calls. 

Terminal arbitration mechanisms. 

The job control mechanism works by associating with each 
process a number called a process group ; related processes 
(e.g. in a pipeline) are given the same process group. The 
system assigns a single process group number to each termi- 
nal. Processes running on a terminal are given read access 
to that terminal only if they are in the same process group 
as that terminal. 

Thus a command interpreter may start several jobs running in 
different process groups and arbitrate access to the termi- 
nal by controlling which, if any, of these processes is m 
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the same process group as the terminal, when a process 

which IS not in the process group of the terminal ?ries to 

read from the terminal, all members of the process group of 

the process receive a SIGTTIN signal, which normally then 

ItaTJ '?r ^°.^t°P,^"til they are continued witSa SIGCOOT 

ttlu)' fnl t^^^^^^i^^^ ^?^ ^ description of these signals! 
tty(4) for a descriotion of nmra^c r.r-«,,r^c \ ^ ' 



rmi- 



tty(4) for a description of process groups.) 

If a process which is not in the process group of the termi- 
nal attempts to change the terminals mode? the proceL groip 
of that process is sent a SIGTTOU signal, causing the pro? 
cess group to stop. A similar mechanism is (optionall?) 

IIgttoS :hen°[hp°^'?^'' ."""^^? processes to block wt?h 
SIGTTOU when they attempt to write to the terminal while not 
?n ^ll process group; this is controlled by the LTOSTOP bit 
ffho Lf^i?? V°^^ enabled by "stty tostop" and disabled 
alllritllTn^'lh ),'''' "'°^'°^-" ^"'^ ^^°^^°^ ^^^ - 

How the shell manipulates process groups. 

A shell which is interactive first establishes its own pro- 
cess group and a process group for the terminal- this 

Shtle thf^^r P^°^f^^^^ f^°"^ being inadvertentTy stopped 
while the terminal is under its control. The shell then 
assigns each job it creates a distinct process group! When 

?«rm?n.i'^ ^S ^ '"''" "'^ ^^^ foreground, the shell gives the 
terminal to the process group of the job using the TIOCSPGRP 

P?etes ^?he sT^^'\''^^ ^^'^^' ^^^^ ^ ^°' s^ops'o^'com- 
pletes, the shell reclaims the terminal by resettina the 

terminals process group to that of the shell using TiScSPGR? 

Shells which are running shell scripts or runnina non- 

c?eatr''I^sLad° T »-'P"l«V^°"" groups'"?" SL ?Sey 
create. Instead, they leave the process group of sub- 
processes and the terminal unchanged. This Lsu?es tha^if 
any sub-process they create blocks for terminal U the 
J^l I ^pd all Its sub-processes will be blocked (sinc4 they 
are a single process group). The first interactive parent 

?he stoppage:' ' ^^^^^ ^^'^ '^^"^ ^^ ^^^<^ ^° ^^^^ ^ith 

Processes which are orphans (whose parents have exited) and 
descendants of these processes are protected by thrs^s^Sm 
from stopping, since there can be nS interactive olrent 
end nf f'^f ^^^^^^^^9, reads from the control ^ermlnal'^^etSrn 
(i r LToItop hl^n'" f? ^l^e control terminal are permttteS 
U.e. LTOSTOP has no effect for these processes.) Similarlv 
processes which ignore or hold the SIGt¥in or SIGTToi signal 
are not sent these signals when accessing their control ter- 
minal; If they are not in the process group of tSe control 
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terminal reads simply return end-of-file. Output and mode 
setting are also allowed. 

Before a shell suspends itself, it places itself back in the 
process group in which it was created, and then sends this 
original group a stopping signal, stopping the shell and any 
other intermediate processes back to an interactive parent. 
The shell also restores the process group of the terminal 
when it finishes, as the process which then resumes would 
not necessarily be in control of the terminal otherwise. 

Naive processes. 

A process which does not alter the state of the terminal, 
and which does no job control can invoke subprocesses nor- 
mally without worry. If such a process issues a system OS) 
call and this command is then stopped, both of the processes 
will stop together. Thus simple processes need not worry 
about job control, even if they have "shell escapes" or 
invoke other processes. 

Processes which modify the terminal state. 

When first setting the terminal into an unusual mode, the 
process should check, with the stopping signals held, that 
it is in the foreground. It should then change the state of 
the terminal, and set the catches for SIGTTIN, SIGTT9U and 
SIGTSTP. The following is a sample of the code that will be 
needed, assuming that unit 2 is known to be a terminal. 

short tpgrp; 



retry: 

sigset(SIGTSTP, SIG_HOLD) ; 
sigset (SIGTTIN, SIG_HOLD) ; 
sigset(SIGTTOU, SIG_HOLD) ; 
if (ioctl(2, TIOCGPGRP, & tpgrp) != 0) 

goto nottty; 
if (tpgrp != getpgrp(O)) { /* not in foreground */ 

sigset(SIGTTOU, SIG_DFL) ; 

kilKO, SIGTTOU); 

/* job stops here waiting for SIGCONT */ 

goto retry; 

} 

. . . save old terminal modes and set new modes . . . 

sigset(SIGTTIN, onstopTl 

sigset (SIGTTOU, onstop) ; 

sigset(SIGTSTP, onstop); 

It is necessary to ignore SIGTSTP in this code because oth- 
erwise our process could be moved from the foreground to the 
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background in the middle of checking if it is in the fore- 
^^j;"?^:. The process holds all the stopping signals in this 
critical section so no other process in our process qrouo 
SfSHr^^f""^ ""P ^^ blocking us on one of these signals in the 
middle of our check. (This code assumes that the command 
interpreter will not move a process from foreground to back- 
ground without stopping it; if it did we would have no way 
of making the check correctly.) ^ 

The routine which handles the signal should clear the catch 
for the stop signal and kill(2) the processes in its process 
group with the same signal. The statement after this kill 
SIGCONt! ^''^''''^^^ ''^^" ^^® process is later continued ^SFith 

Thus the code for the catch routine might look like: 

• • • 

sigset(SIGTSTP, onstop); 
sigset(SIGTTIN, onstop); 
sigset(SIGTTOU, onstop); 

• • « 

onstop(signo) 

int signo; 
{ 

• • • restore old terminal state . . . 

sigsetTsIgno, SIG_DFL); 

kilKO, signo); 

/* stop here until continued */ 

sigset(signo, onstop); 

... re store our special terminal state . . . 



This routine can also be used to simulate a stop signal. 

If a process does not need to save and restore state when it 
IS stopped, but wishes to be notified when it is continued 

hf^^?" ^ ^•?? t^ ""^^ ''^^''^ ^^® SIGCONT signal; the SIGCONT 
handler will be run when the process is continued. 

Processes which lock data bases such as the password file 
fj^^'i . '?"°''^ SIGTTIN, SIGTTOU, and SIGTSTP signals while 
the data bases are being manipulated, while a process is 
ignoring SIGTTIN signals, reads which would normally have 
hung will return end-of-file; writes which would normally 
S?G?ToS^rUrer" ^^^"^^^ ^^^ instead permitted whilJ 



Interrupt-level process handli 



ng, 
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Using the mechanisms of sigset OJ) it is possible to handle 
process state changes as they occur by providing an 
interrupt-handling routine for the SIGCHLD signal which 
occurs whenever the status of a child process changes. A 
signal handler for this signal is established by: 

sigsetC SIGCHLD, onchild); 

The shell or other process would then await a change in 
child status with code of the form: 

sighold(SIGCHLD); /* start critical section */ 
if (no children to process ) { 

~iigpause(SIGCHLDTl 7* release SIGCHLD and pause */ 
goto recheck; 

sigrelse(SIGCHLD); /* end critical region */ 
/* now have a child to process */ 

Here we are using sighold to temporarily block the SIGCHLD 
signal during the checking of the data structures telling us 
whether we have a child to process. If we didn't block the 
signal we would have a race condition since the signal might 
corrupt our decision by arriving shortly after we had fin- 
ished checking the condition but before we paused. 

If we need to wait for something to happen, we call sigi^ause 
which automatically releases the hold on the SIGCHLD signal 
and waits for a signal to occur by starting a pause! 2) . 
Otherwise we simply release the SIGCHLD signal and process 
the child. Sigpause is similar to the PDP-11 wait instruc- 
tion, which returns the priority of the processor to the 
base level and idles waiting for an interrupt. 

It is important to note that the long-standing bug in the 
signal mechanism which would have lost a SIGCHLD signal 
which occurred while the signal was blocked has been fixed. 
This is because sighold uses the SIG_HOLD signal set of 
sigsys(2J) to prevent the signal action from being taken 
without losing the signal if it occurs. Similarly, a signal 
action set with sigset has the signal held while the action 
routine is running, much as a the interrupt priority of the 
processor is raised when a device interrupt is taken. 

In this interrupt driven style of termination processing it 
is necessary that the wait calls used to retrieve status in 
the SIGCHLD signal handler not block. This is because a 
single invocation of the SIGCHLD handler may indicate an 
arbitrary number of process status changes: signals are not 
queued. This is similar to the case in a disk driver where 
several drives on a single controller may report status at 
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once, while there is only one interrupt taken. it is even 

tSf'sirrmn ""S ^S?^^^^'} ^^ .^^ f^^^y to report status when 
the SIGCHLD handler xs invoked, if the signal was oosted 
while the SIGCHLD handler was active, and ?he child wis 
noticed due to a SIGCHLD initially sent for another process. 
This causes no problem, since the handler will be called 
whenever there is work to do; the handler just has to col- 
lect all information by calling wait3 until it says no more 
information is available. F^Irthir status changes arl 
guaranteed to be reflected in another SIGCHLD handler call. 

Restarting system calls. 

In older versions of UNIX "slow" system calls were inter- 
rupted when signals occurred, returning EINTR. The new sia- 
nal mechanism sigset Qj) normally restarts such calls rather 
than interrupting them. To summarize: pause and wait return 
error EINTR (as before), loctl and waitST^tal^t^d reaS 
and write restart unless some dataT^s read or writteiTTH 
which case they return indicating how much data was read or 
Tc^o ^'n in programs which use the older siqnal (2) mechan- 
dSg tie°can!'' " ^ '^'^'" '^'^''^ '' i-^nal occurs 

SEE ALSO 

iflillo.^ '°-^^^?h^ J^illpg(2), setpgrp(2), sigsys(2j), 
wait2(2J), signal(2), tty(4) ^ jr ^ /, 

RESTRICTIONS 

The job control facilities are not available in standard 
version 7 UNIX. These facilities are still under develop- 
ment and may change in future releases of the system as 
better inter-process communication facilities and support 
for virtual terminals become available. The options and 
specifications of these system calls and even the calls 
themselves are thus subject to change. 
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NAME ^ , ^ 

abort - generate lOT fault 

SYNOPSIS 

abort ( ) 

DESCRIPTION ^^^ instruction. This causes a 

illHil^hat normally terminates the process with a core 
dump, which may be used for debugging. 

SEE ALSO , ^ . _. 

adb(l), signal(2), exit(2) 

DIAGNOSTICS ^ ^, , ..^ ^u^^^ 

Usually ' lOT trap - core dumped' from the sfteii. 
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NAME 

abs - integer absolute value 

SYNOPSIS 

abs ( i ) 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

SEE ALSO 

floorO) for fabs 

RESTRICTIONS 

In^e^er.""" "" """""^ «"«^ °" '"e largest negative 
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NAME 

assert - program verification 

SYNOPSIS 

finclude <assert.h> 

assert (expression) 

DESCRIPTION . . . J . 

Assert is a macro that indicates expression xs expected to 
bi true at this point in the program. It causes an exit (2) 
with a diagnostic comment on the standard output when 
expression is false (0). Compiling with the cc(l) option 
-DNDEBUG effectively deletes assert from the program. 

DIAGNOSTICS , , 

'Assertion failed: file f line n. ' F is the source file and 
n the source line n\amber of the assert statement. 
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NAME 

atof, atoi, atol - convert ASCII to numbers 

SYNOPSIS 

double atof(nptr) 
char *nptr; 

atoi(nptr) 
char *nptr; 

long atoKnptr) 
char *nptr; 

DESCRIPTION 

These functions convert a string pointed to by nptr to 
floating integer, and long integer representation~7iipec- 
tively. The first unrecognized character ends the string. 

Atoi recognizes an optional string of tabs and spaces, then 
an_ optional sign, then a string of digits optionally con- 
taining a decimal point, then an optional 'e' or 'E' fol- 
lowed by an optionally signed integer. 

Atoi and atol recognize an optional string of tabs and 
spaces, then an optional sign, then a string of digits. 

SEE ALSO 

scanf (3) 

RESTRICTIONS 

There are no provisions for overflow. 
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NAME 

crypt, encrypt - a one way hashing encryption algorithm 

SYNOPSIS 

char *crypt(key, salt) 
char *key, *salt; 

encrypt(block) 
char *block; 

DESCRIPTION 

Crypt is the password encryption routine. It is based on a 
one way hashing encryption algorithm with variations 
intended (among other things) to frustrate use of hardware 
implementations of a key search 

Key is a user's typed password. Salt is a two-character 
itring chosen from the set [a-zA-ZO-9./] ; this string is 
used to perturb the hashing algorithm in one of 4096 dif- 
ferent ways, after which the password is used as the key to 
encrypt repeatedly a constant string. The returned value 
points to the encrypted password. The first two characters 
are the salt itself. 

There is a character array of length 64 containing only the 
characters with nxomerical value and 1. When this string 
is divided into groups of 8, the low-order bit in each group 
is ignored, leading to a 56-bit key which is set into the 
machine by crypt. 

The encrypt entry provides (rather primitive) access to the 
actual hashing algorithm. The argument to the encrypt entry 
is a character array of length 64 containing only the char- 
acters with numerical value of and 1. The argument array 
is modified in place to a similar array representing the 
bits of the argument after having been subjected to the 
hashing algorithm using the key set by crypt . 

SEE ALSO 

passwd(l), passwd(5), login(l), getpassO) 

RESTRICTIONS 

The return value points to static data whose content is 

overwritten by each call. 
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NAME 



ctime, localtime, gmtime, asctime, timezone - convert date 
and time to ASCII 



SYNOPSIS 

char *ctime{clock) 
long *clock; 

#include <time.h> 

struct tm *localtime(clock) 
long *clock; 

struct tm *gmtime(clock) 
long *clock; 

char *asctime(tm) 
struct tm *tm; 

char *timezone(zone, dst) 

DESCRIPTION 

Ctime converts a time pointed to by clock such as returned 
by time(2) into ASCII and returni i pointer to a 26- 
character string in the following form. All the fields have 
constant width. 

Sun Sep 16 01:03:52 1973\n\0 

Localtime and gmtime return pointers to structures contain- 
ing the broken-down time. Localtime corrects for the time 
zone and possible daylight savings time; gmtim e converts 
directly to GMT, which is the time UNIX usel. Asctime con- 
verts a broken-down time to ASCII and returns a pointer to a 
26-character string. 



The 



structure declaration from the include file is: 



/* 
* SCCSID: (a(#)time.h 
*/ 

struct tm { /* see ctime(3) */ 

int tm_sec; 

int tm_min; 

int tm_hour; 

int tm_mday; 

int tm_mon; 

int tm_year; 

int tm_wday; 

int tm_yday; 

int tm isdst; 

}; - 



1.0 11/12/83 
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These quantities give the time on a 24-hour clock, day of 
month (1-31), month of year (0-11), day of week (Sunday = 
0), year - 1900, day of year (0-365), and a flag that is 
nonzero if daylight saving time is in effect. 

When local time is called for, the program consults the sys- 
tem to determine the time zone and whether the standard 
U.S.A. daylight saving time adjustment is appropriate. The 
program knows about the peculiarities of this conversion in 
1974 and 1975; if necessary, a table for these years can be 
extended. 

Timezone returns the name of the time zone associated with 
Its first argument, which is measured in minutes westward 
from Greenwich. If the second argument is 0, the standard 
name is used, otherwise the Daylight Saving version. If the 
required name does not appear in a table built into the rou- 
tine, the difference from GMT is produced; e.g. in Afghan- 
istan timezone (-(60*4+30) , 0) is appropriate because it is 
4:30 ahead of GMT and the string GMT+4:30 is produced. 

SEE ALSO 

time(2) 

RESTRICTIONS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 



isalpha, 
ispunct, 
tion 



1 supper, 
isprint. 



SYNOPSIS 

# include <ctype.h> 

isalpha(c) 



islower, isdigit, isalnum, isspace, 
iscntrl, isascii - character classifica- 



DESCRIPTION 

These macros classify ASCII-coded integer values by table 
lookup. Each is a predicate returning nonzero for true 
zero for false. Isascii is defined on all integer values- 
the rest are defined only where isascii is true and on the 
single non-ASCII value EOF (see stdio (3)) 



isalpha 
i supper 
islower 
isdigit 
isalnum 
isspace 

ispunct 

isprint 

iscntrl 

isascii 

SEE ALSO 

ascii (7) 



c is a letter 

c is an upper case letter 

c is a lower case letter 

c is a digit 

c is an alphanumeric character 

c is a space, tab, carriage return, newline, 
or formfeed 

c is a punctuation character (neither control 
nor alphanumeric) 



c is a printing character, code 
(space) through 0176 (tilde) 



040(8) 



c is a delete character (0177) or ordinary 
control character (less than 040). 

c is an ASCII character, code less than 0200 
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NAME 



curses - screen functions with "optimal" cursor motion 



SYNOPSIS 

cc [ flags ] files -Icurses -Itermlib [ libraries ] 

DESCRIPTION 

These routines give the user a method of updating screens 
with reasonable optimization. They keep an image of the 
current screen, and the user sets up an image of a new one. 
Then the refresh O tells the routines to make the current 
screen look like the new one. In order to initialize the 
routines, the routine inrtscr ( ) must be called before any of 
the other routines that deal with windows and screens are 
used. The routine endwinO should be called before exiting. 



SEE ALSO 

Screen Updating and Cursor Movement Optimization ; A 

Package , Ken Arnold, 

stty(2) , setenvO), termcap(5) 



Library 



AUTHOR 

Ken Arnold 



FUNCTIONS 

addch(ch) 
addstr(str) 
box(win,vert ,hor) 
crmode( ) 
clear( ) 

clearok(scr,boolf ) 
clrtobot ( ) 
clrtoeoK ) 
delchO 
deleteln( ) 
delwin(win) 
echo( ) 
endwin( ) 
erase( ) 
getch( ) 
getcap(name) 

getstr(str) 

gettmode( ) 

getyx(win,y,x) 

inch( ) 

initscr( ) 

inschCc) 

insertln( ) 

leaveok(win,boolf ) 

longname ( termbuf , name ) 

move(y,x) 

mvcur { lasty , lastx , newy , newx ) 



add a character to stdscr 

add a string to stdscr 

draw a box around a window 

set cbreak mode 

clear stdscr 

set clear flag for scr 

clear to bottom on stdscr 

clear to end of line on stdscr 

delete a character 

delete a line 

delete win 

set echo mode 

end window modes 

erase stdscr 

get a char through stdscr 

get terminal capability name 

get a string through stdscr 

get tty modes 

get {y,x) co-ordinates 

get char at current (y,x) co-ordinates 

initialize screens 

insert a char 

insert a line 

set leave flag for win 

get long name from termbuf 

move to (y,x) on stdscr 

actually move cursor 
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newwin( lines, cols, begin_y, 
nl() 

nocrmode( ) 

noecho( ) 

nonl( ) 

noraw( ) 

over lay (winl,win2) 

overwrite(winl,win2) 

printw(fnit,argl,arg2, . . . ) 

rawO 

refresh( ) 

resetty{ ) 

savetty( ) 

scanw( fmt , argl , arg2 , . . . ) 

scrolKwin) 

scrollok(win,boolf ) 

set term (name) 

standend( ) 

standout ( ) 

subwin(win, lines, cols, begi 

touchwin{win) 

unctrl(ch) 

waddch(win,ch) 

waddstr(win,str) 

wclear(win) 

wclrtobot(win) 

wclrtoeol(win) 

wdelch(win,c) 

wdeleteln{win) 

werase(win) 

wgetch{win) 

wgetstr(win,str) 

winch(win) 

winsch(win,c) 

winsertln(win) 

wmove(win,y,x) 

wprintw( win, fmt , argl , arg2 , 

wrefresh(win) 

wscanw(win, fmt, argl, arg2, . 

wstandendCwin) 

wstandout(win) 



begin_x) create a new window 

set newline mapping 

unset cbreak mode 

unset echo mode 

unset newline mapping 

unset raw mode 

overlay winl on win2 

overwrite winl on top of win2 

printf on stdscr 

set raw mode 

make current screen look like stdscr 

reset tty flags to stored value 

stored current tty flags 

scanf through stdscr 

scroll win one line 

set scroll flag 

set term variables for name 

end standout mode 

start standout mode 
n_y,begin_x) create a subwindow 

"change" all of win 

printable version of ch 

add char to win 

add string to win 

clear win 

clear to bottom of win 

clear to end of line on win 

delete char from win 

delete line from win 

erase win 

get a char through win 

get a string through win 

get char at current (y,x) in win 

insert char into win 

insert line into win 

set current (y,x) co-ordinates on win 
. ..) printf on win 

make screen look like win 
. . ) scanf through win 

end standout mode on win 

start standout mode on win 
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NAME 

dbminit, fetch, store, delete, firstkey, nextkey - data base 
subroutines 

SYNOPSIS 

typedef struct { char *dptr; int dsize; } datum; 

dbminit (file) 
char *file; 

datum fetch{key) 
datum key; 

store{key, content) 
datum key, content; 

delete(key) 
datum key; 

datum firstkeyO; 

datum nextkey(key) ; 
datum key; 

DESCRIPTION 

These functions maintain key/content pairs in a data base. 
The functions will handle very large (a billion blocks) 
databases and will access a keyed item in one or two 
filesystem accesses. The functions are obtained with the 
loader option -Idbm. 

Key s and content s are described by the datum typedef. A 
datum specifies a string of dsize bytes pointed to by dptr . 
Arbitrary binary data, as well as normal ASCII strings, are 
allowed. The data base is stored in two files. One file is 
a directory containing a bit map and has ' .dir' as its suf- 
fix. The second file contains all data and has ' .pag' as 
its suffix. 

Before a database can be accessed, it must be opened by 
dbminit . At the time of this call, the files file . dir and 
file . pag must exist. (An empty database is created by 
creating zero-length '.dir' and '.pag' files.) 

Once open, the data stored under a key is accessed by fetch 
and data is placed under a key by store . A key (and its 
associated contents) is deleted by delete . A linear pass 
through all keys in a database may be made, in an 
(apparently) random order, by use of firstkey and nextkey . 
Firstkey will return the first key in the database. With 
any key nextkey will return the next key in the database. 
This code will traverse the data base: 
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for{key=f irstkeyO; key.dptr ! =NULL; key=nextkey(key) ) 

DIAGNOSTICS 

All functions that return an int indicate errors with nega- 
tive values. A zero return indicates ok. Routines that 
return a datum indicate errors with a null (0) dptr . 

RESTRICTIONS 

The '.pag' file will contain holes so that its apparent size 
is about four times its actual content. Older UNIX systems 
may create real file blocks for these holes when touched. 
These files cannot be copied by normal means (cp, cat, tp, 
tar, ar) without filling in the holes. 

Dptr pointers returned by these subroutines point into 
static storage that is changed by subsequent calls. 

The sum of the sizes of a key/content pair must not exceed 
the internal block size (currently 512 bytes). Moreover all 
key/content pairs that hash together must fit on a single 
block. Store will return an error in the event that a disk 
block fills with inseparable data. 

Delete does not physically reclaim file space, although it 
does make it available for reuse. 

The order of keys presented by firstkey and nextkey depends 
on a hashing function, not on anything interesting. 
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NAME 

ecvt, fcvt, gcvt - output conversion 

SYNOPSIS 

char *ecvt(value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *fcvt(value, ndigit, decpt, sign) 

double value; 

int ndigit, *decpt, *sign; 

char *gcvt (value, ndigit, buf) 
double value; 
char *buf; 

DESCRIPTION 

Ecvt converts the value to a null-terminated string of ndi- 
git ASCII digits and returns a pointer thereto. The posi- 
tion of the decimal point relative to the beginning of the 
string is stored indirectly through decpt (negative means to 
the left of the returned digits). If the sign of the result 
is negative, the word pointed to by sign is non-zero, other- 
wise it is zero. The low-order digit is rounded. 

Fcvt is identical to ecvt, except that the correct di has 
been rounded for Fortran F-format output of the number of 
digits specified by ndigits . 

Gcvt converts the value to a null-terminated ASCII string in 
buf and returns a pointer to buf . It attempts to produce 
ndigit significant digits in Fortran F format if possible, 
otherwise E format, ready for printing. Trailing zeros may 
be suppressed. 

SEE ALSO 

printf (3) 

RESTRICTIONS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 

end, etext, edata - last locations in program 

SYNOPSIS 

extern end; 
extern etext; 
extern edata; 

DESCRIPTION 

These names refer neither to routines nor to locations with 
interesting contents. The address of etext is the first 
address above the program text, edata above the initialized 
data region, and end above the uninitialized data region. 

When execution begins, the program break coincides with end, 
but many functions reset the program break, among themThe 
routines of brk(2), malloc Q), standard input/output 
( stdio O)), the profile Fp) option of cc(l), etc. The 
current value of the program break is reliably returned bv 
'sbrk(O) • , see brk(2). ^ 

SEE ALSO 

brk(2), mallocO) 
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NAME 

exp, log, loglO, pow, sqrt - exponential, logarithm, power, 
square root 

SYNOPSIS 

# include <math.h> 

double exp{x) 
double x; 

double log(x) 
double x; 

double loglO(x) 
double x; 

double pow(x, y) 
double X, y; 

double sqrt(x) 
double x; 

DESCRIPTION 

Exp returns the exponential function of x. 

Log returns the natural logarithm of x; loglO returns the 
base 10 logarithm. 

Pov returns x . 

Sqrt returns the square root of x. 

SEE ALSO 

hypotO), sinh(3), intro(2) 

DIAGNOSTICS 

Exp and pov return a huge value when the correct value would 
overflow; errno is set to ERANGE. Pow returns and sets 
errno to EDOM when the second argument is negative and non- 
mtegral and when both argijments are 0. 

Log returns when x is zero or negative; errno is set to 
EDOM. 

Sqrt returns when x is negative; errno is set to EDOM. 
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NAME 

fclose, fflush - close or flush a stream 

SYNOPSIS 

#include <stdio.h> 

fclose(stream) 
FILE *stream; 

fflush( stream) 
FILE *stream; 

DESCRIPTION 

Fclose causes any buffers for the named stream to be emp- 
tied, and the file to be closed. Buffers allocated by the 
standard input/output system are freed. 

Fclose is performed automatically upon calling exit (2) . 

^fl^sh causes any buffered data for the named output strea m 
to be written to that file. The stream remains open. 

SEE ALSO 

close(2), fopenO), setbufO) 

DIAGNOSTICS 

These routines return EOF if stream is not associated with 
an output file, or if buffered data cannot be transferred to 
that file. 
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NAME . . 

feof, ferror, clearerr, fileno - stream status inquiries 

SYNOPSIS 

# include <stdio.h> 

feof (stream) 
FILE *stream; 

ferror (stream) 
FILE *stream 

clearerr (stream) 
FILE *stream 

f ileno(stream) 
FILE *stream; 

DESCRIPTION 

Feof returns non-zero when end of file is read on the named 
input stream, otherwise zero. 

Ferror returns non-zero when an error has occurred reading 
or writing the named stream , otherwise zero. Unless cleared 
by clearerr , the error indication lasts until the stream is 
closed. 

Clrerr resets the error indication on the named stream. 

Fileno returns the integer file descriptor associated with 
the stream , see open (2) . 

These functions are implemented as macros; they cannot be 
redeclared. 

SEE ALSO 

fopenO), open(2) 
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NAME 

fabs, floor, ceil - absolute value, floor, ceiling functions 

SYNOPSIS 

#include <niath.h> 

double floor(x) 
double x; 

double ceil(x) 
double x; 

double fabs(x) 
double (x) ; 

DESCRIPTION 

Fabs returns the absolute value |x| . 

Floor returns the largest integer not greater than x. 

Ceil returns the smallest integer not less than x. 

SEE ALSO 

abs(3) 
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NAME 

fopen, f reopen, fdopen - open a stream 

SYNOPSIS 

#include <stdio.h> 

FILE *fopen{ filename, type) 
char *filename, *type; 

FILE *freopen( filename, type, stream) 
char *filename, *type; 
FILE *stream; 

FILE *fdopen(f ildes, type) 
char *type; 

DESCRIPTION 

Fopen opens the file named by filename and associates a 
stream with it. Fopen returns a pointer to be used to iden- 
tify the stream in subsequent operations. 

Type is a character string having one of the following 
values: 

n -. II 



"..t" 



r" open for reading 

w" create for writing 

"a" append: open for writing at end of file, or create for 
writing 

Freopen substitutes the named file in place of the open 
stream . It returns the original value of stream . The ori- 
ginal stream is closed. 

Freopen is typically used to attach the preopened constant 
names, stdin, stdout, stderr, to specified files. 

Fdopen associates a stream with a file descriptor obtained 
from open , dup , creat , or pipe (2). The type of the stream 
must agree with the mode of the open file. 

SEE ALSO 

open(2), fcloseO) 

DIAGNOSTICS 

Fopen and freopen return the pointer NULL if filename cannot 

be accessed. 

RESTRICTIONS 

Fdopen is not portable to systems other than UNIX. 
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NAME 

fread, fwrite - buffered binary input/output 

SYNOPSIS 

#include <stdio.h> 

fread(ptr, sizeof (*ptr) , nitems, stream) 
FILE *stream; 

fwrite(ptr, sizeof (*ptr) , nitems, stream) 
FILE *stream; 

DESCRIPTION 

£read reads, into a bloc)c beginning at ptr, nitems of data 

of the type of *£tr from the named input stream. It returns 

the number of items actually read. 

Fwrite appends at most nitems of data of the type of *Dtr 
beginning at £tr to the named output stream. It returns tEi 
number of items actually written. cuunii, tne 

SEE ALSO 

^"^u!; prli^ll^!; scaSf?^?'' '"='^'- p^'^'^'- '«'^'^'' 

DIAGNOSTICS 

Fread and f write return upon end of file or error. 
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NAME 

frexp, Idexp, modf - split into mantissa and exponent 

SYNOPSIS 

double frexp(value, eptr) 
double value; 
int *eptr; 

double ldexp( value, exp) 
double value; 

double modf (value, iptr) 
double value, *iptr; 

DESCRIPTION 

Frexp returns the mantissa of a double value as a double 
quantity, x, of magnitude less than 1 and stores an integer 
n such that value = x*2**n indirectly through eptr . 

Ldexp returns the quantity value *2** exp . 

Modf returns the positive fractional part of value and 
stores the integer part indirectly through iptr . 
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NAME 

fseek, ftell, rewind - reposition a stream 

SYNOPSIS 

finclude <stdio.h> 

fseek(stream, offset, ptrname) 
FILE *stream; 
long offset; 

long ftell (stream) 
FILE *stream; 

rewind( stream) 

DESCRIPTION 

Fseek sets the position of the next input or output opera- 
tion on the stream . The new position is at the signed dis- 
tance offset bytes from the beginning, the current position, 
or the end of the file, according as ptrname has the value 
0, 1, or 2. 

Fseek undoes any effects of ungetc Q) . 

Ftell returns the current value of the offset relative to 
the beginning of the file associated with the named stream. 
It IS measured in bytes on UNIX; on some other systems it is 
a magic cookie, and the only foolproof way to obtain an 
offset for fseek . 

Rewind ( stream ) is equivalent to fseek ( stream , OL, 0). 

SEE ALSO 

lseek(2), fopenO) 

DIAGNOSTICS 

Fseek returns -1 for improper seeks. 
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NAME 

getc, getchar, fgetc, getw - get character or word from 
stream 

SYNOPSIS 

#include <stdio.h> 

int getc(stream) 
FILE *stream; 

int getchar( ) 

int fgetc(stream) 
FILE *stream; 

int getw(stream) 
FILE *stream; 

DESCRIPTION 

Getc returns the next character from the named input stream . 

Getchar ( ) is identical to getc ( stdin ) . 

Fgetc behaves like getc , but is a genuine function, not a 
macro; it may be used to save object text. 

Getv returns the next word from the named input stream . It 
returns the constant EOF upon end of file or error, but 
since that is a good integer value, feof and ferror O) 
should be used to check the success of getw . Getw assumes 
no special alignment in the file. 

SEE ALSO 

fopenO), putcO), getsO), scanfO), freadO), ungetcO) 

DIAGNOSTICS 

These functions return the integer constant EOF at end of 
file or upon read error. 

A stop with message, 'Reading bad file', means an attempt 
has been made to read from a stream that has not been opened 
for reading by fopen . 

RESTRICTIONS 

The end-of-file return from getchar is incompatible with 
that in UNIX editions 1-6. 

Because it is implemented as a macro, getc treats a stream 
argument with side effects incorrectly. In particular, 
'getc(*f++) ; • doesn't work sensibly. 
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NAME 

getenv - value for environment name 

SYNOPSIS 

char *getenv(name) 
char *name; 

DESCRIPTION 

Getenv searches the environment list (see environ (5) ) for a 
string of the form name = value and returns value if such a 
string is present, otherwise (NULL) . 

SEE ALSO 

environ(5), exec(2) 
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NAME 

getgrent, getgrgid, getgrnam, setgrent, endgrent - get group 
file entry 

SYNOPSIS 

tinclude <grp.h> 

struct group *getgrent(); 

struct group *getgrgid(gid) int gid; 

struct group *getgrnam(name) char *name; 

int setgrent(); 

int endgrent(); 

DESCRIPTION 

Getgrent , getgrgid and getgrnam each return pointers to an 
object with the following structure containing the broken- 
out fields of a line in the group file. 

/* 
* SCCSID: @(#)grp.h 1.0 11/12/83 
*/ 
struct group { /* see getgrent (3) */ 
char *gr_name; 
char *gr_passwd; 
int gr_gid; 
char **gr mem; 
}; 

The members of this structure are: 

gr_name 

The name of the group. 
gr_passwd 

The encrypted password of the group. 
gr_gid 

The numerical group-ID. 
gr_mem 

Null-terminated vector of pointers to the individual 

member names. 

Getgrent simply reads the next line while getgrgid and get- 
grnam search until a matching gid or name is found (or until 
EOF IS encountered). Each routine picks up where the others 
leave off so successive calls may be used to search the 
entire file. 
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A call to setgrent has the effect of rewinding the group 
file to allow repeated searches. Endgrent may be called to 
close the group file when processing is complete. 

FILES 

/etc/group 

SEE ALSO 

getlogin(3), getpwent(3), group(5) 

DIAGNOSTICS 

A null pointer (0) is returned on EOF or error. 

RESTRICTIONS 

All information is contained in a static area so it must be 
copied if it is to be saved. 
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NAME 

getlogin - get login name 

SYNOPSIS 

char *getlogin(); 

DESCRIPTION 

Getlogin returns a pointer to the login name as found in 
/ etc / utmp . It may be used in conjunction with getpwnam to 
locate the correct password file entry when the same userid 
is shared by several login names. 

If getlogin is called within a process that is not attached 

to a typewriter, it returns NULL. The correct procedure for 

determining the login name is to first call getlogin and if 
it fails, to call getpwuid . 

FILES 

/etc/utmp 

SEE ALSO 

getpwent ( 3 ) , getgrent ( 3 ) , utmp { 5 ) 

DIAGNOSTICS 

Returns NULL (0) if name not found. 

RESTRICTIONS 

The return values point to static data whose content is 
overwritten by each call. 
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NAME 

getpass - read a password 

SYNOPSIS 

char *getpass (prompt) 
char *prompt; 

DESCRIPTION 

Getpass reads a password from the file / dev / tty , or if that 
cannot be opened, from the standard input, after prompting 
with the null-terminated string prompt and disabling echo- 
ing. A pointer is returned to a null-terminated string of 
at most 8 characters. 

FILES 

/dev/tty 

SEE ALSO 

crypt (3) 

RESTRICTIONS 

The return value points to static data whose content is 
overwritten by each call. 
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NAME 

getpw - get name from UID 

SYNOPSIS 

getpw(uid, buf) 
char *buf; 

DESCRIPTION 

Getpw searches the password file for the (numerical) uid, 
and fills in buf with the corresponding line; it returns 
non-zero if uid could not be found. The line is null- 
terminated. 

FILES 

/etc/passwd 

SEE ALSO 

getpwent ( 3 ) , passwd ( 5 ) 

DIAGNOSTICS 

Non-zero return on error. 



GETPWENT ( 3 ) GETPWENT ( 3 ) 



NAME 



getpwent, getpwuid, getpwnam, setpwent, endpwent - get pass- 
word file entry 



SYNOPSIS 

# include <pwd.h> 

struct passwd *getpwent(); 

struct passwd *getpwuid(uid) int uid; 

struct passwd *getpwnam(name) char *name; 

int setpwent (); 

int endpwentO; 

DESCRIPTION 

Getpwent , getpwuid and getpwnam each return a pointer to an 
object with the following structure containing the broken- 
out fields of a line in the password file. 

/* 
* SCCSID: @(#)pwd.h 1.0 11/12/83 
*/ 
struct passwd { /* see getpwent (3) */ 

char *pw_name; 

char *pw_passwd; 

int pw_uid; 

int pw_gid; 

int pw_quota; 

char *pw_conunent ; 

char *pw_gecos; 

char *pw_dir; 

char *pw_shell; 
}; 

The fields pw quota and pw comment are unused; the others 
have meanings described in passwdT S) . 

Getpwent reads the next line (opening the file if neces- 
sary); s'etpwent rewinds the file; endpwent closes it. 

Getpwuid and getpwnam search from the beginning until a 
matching uid or name is found (or until EOF is encountered). 

FILES 

/etc/passwd 

SEE ALSO 

getlogin(3), getgrent(3), passwd(5) 
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DIAGNOSTICS 

Null pointer (0) returned on EOF or error. 

RESTRICTIONS 

All information is contained in a static area so it must be 
copied if it is to be saved. 
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NAME 

gets, fgets - get a string from a stream 

SYNOPSIS 

#include <stdio.h> 

char *gets{s) 
char *s; 

char *fgets(s, n, stream) 
char *s; 
FILE *stream; 

DESCRIPTION 

Gets reads a string into s from the standard input stream 
stdin. The string is terminated by a newline character, 
which IS replaced in s by a null character. Gets returns 
Its argument. 

Fgets reads n-1 characters, or up to a newline character, 
whichever comes first, from the stream into the string s. 
The last character read into s is followed by a null charac- 
ter. Fgets returns its first argument. 

SEE ALSO 

puts(3), getc{3), scanf(3), freadO), ferrorO) 

DIAGNOSTICS 

Gets and fgets return the constant pointer NULL upon end of 
file or error. 

RESTRICTIONS 

Gets deletes a newline, fgets keeps it, all in the name of 
backward compatibility. 
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NAME 

hypot, cabs - euclidean distance 

SYNOPSIS 

# include <math.h> 

double hypot (x, y) 
double X, y; 

double cabs{z) 

struct { double x, y;} z; 

DESCRIPTION 

Hypot and cabs return 

sqrt(x*x + y*y> , 

taking precautions against unwarranted overflows. 

SEE ALSO 

exp(3) for sqrt 
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NAME 

jO, jl, jn, yO, yl, yn - bessel functions 

SYNOPSIS 

# include <niath.h> 

double jO(x) 
double x; 

double jKx) 
double x; 

double jn(n, x); 
double x; 

double yO(x) 
double x; 

double yl(x) 
double x; 

double yn(n, x) 
double x; 

DESCRIPTION 

These functions calculate Bessel functions of the first and 
second kinds for real argximents and integer orders. 

DIAGNOSTICS 

Negative arguments cause y^, ^, and yn to return a huge 
negative value and set errno to EDOM. 
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NAME 

13tol, ltol3 - convert between 3-byte integers and long 
integers 

SYNOPSIS 

13tol(lp, cp, n) 
long *lp; 
char *cp; 

ltol3(cp, Ip, n) 
char *cp; 
long *lp; 

DESCRIPTION 

L3tol converts a list of n three-byte integers packed into a 
character string pointed to by eg into a list of long 
integers pointed to by Ip . 

Ltol3 performs the reverse conversion from long integers 
dp) to three-byte integers (cp) • 

These functions are useful for file-system maintenance; disk 
addresses are three bytes long. 

SEE ALSO 

filsys(5) 
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NAME 

malloc, free, realloc, calloc - main memory allocator 

SYNOPSIS 

char *malloc(size) 
unsigned size; 

free(ptr) 
char *ptr; 

char *realloc(ptr, size) 
char *ptr; 
unsigned size; 

char *calloc(nelem, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

M^^loc and free provide a simple general-purpose memory 
allocation package. Malloc returns a pointer to a block of 
at l^ast size bytes beginning on a word boundary. 

The argument to free is a pointer to a block previously 
allocated by malloc ; this space is made available for 
further allocation, but its contents are left undisturbed. 

Needless to say, grave disorder will result if the space 
assigned by malloc is overrun or if some random number is 
handed to free . 

Malloc allocates the first big enough contiguous reach of 
free space found in a circular search from the last block 
allocated or freed, coalescing adjacent free blocks as it 
searches. it calls sbrk (see break(2)) to get more memory 
from the system when there is no suitable space already 
free. ^ 

Realloc changes the size of the block pointed to by ptr to 
size bytes and returns a pointer to the (possibly moved) 
block. The contents will be unchanged up to the lesser of 
the new and old sizes. 

Realloc also works if £tr points to a block freed since the 
last call of malloc , realloc or calloc ; thus sequences of 
iree, mallo c and realloc can exploit the search strategy of 
malloc to do storage compaction. 

^?^^oc allocates space for an array of nelem elements of 
size elsize . The space is initialized to zeros. 

Each of the allocation routines returns a pointer to space 
suitably aligned (after possible pointer coercion) for 
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Storage of any type of object. 

DIAGNOSTICS 

Malloc, realloc and calloc return a null pointer (0) if 
there is no available memory or if the arena has been 
detectably corrupted by storing outside the bounds of a 
block. Malloc may be recompiled to check the arena very 
stringently on every transaction; see the source code. 

RESTRICTIONS 

When realloc returns 0, the block pointed to by ptr may be 
destroyed. 
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NAME 

mktemp - make a unique file name 

SYNOPSIS 

char *mktemp( template) 
char *template; 

DESCRIPTION 

Mktemp replaces template by a unique file name, and returns 
the address of the template. The template should look like 
a file name with six trailing X's, which will be replaced 
with the current process id and a unique letter. 

SEE ALSO 

getpid(2) 
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NAME 

monitor - prepare execution profile 

SYNOPSIS 

monitor (lowpc, highpc, buffer, bufsize, nfunc) 
int {*lowpc)( ), (*highpc){ ); 
short buffer[ ]; 

DESCRIPTION 

An executable program created by 'cc -p' automatically 
includes calls for monitor with default parameters; monitor 
needn't be called explicitly except to gain fine control 
over profiling. 

Monitor is an interface to prof il (2) . Lowpc and highpc are 
the addresses of two functions; buffer is the address of a 
(user supplied) array of bufsize short integers. Monitor 
arranges to record a histogram of periodically sampled 
values of the program counter, and of counts of calls of 
certain functions, in the buffer. The lowest address sam- 
pled is that of lowpc and the highest is just below highpc . 
At most nfunc call counts can be kept; only calls of func- 
tions compiled with the profiling option -p of cc(l) are 
recorded. For the results to be significant, especially 
where there are small, heavily used routines, it is sug- 
gested that the buffer be no more than a few times smaller 
than the range of locations sampled. 

To profile the entire program, it is sufficient to use 

extern etext( ) ; 

« « • 

monitor( ( int)2, etext, buf, bufsize, nfunc); 

Etext lies just above all the program text, see end (3) . 

To stop execution monitoring and write the results on the 
file mon.out, use 

monitor(O) ; 

then prof (1) can be used to examine the results. 

FILES 

mon.out 

SEE ALSO 

prof(l), profil(2), cc(l) 
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NAME 



itom, madd, msub, mult, mdiv, min, mout, pow, gcd, 
multiple precision integer arithmetic 



rpow 



SYNOPSIS 

typedef struct { int len; short *val; } mint; 

madd ( a , b , c ) 
msub(a, b, c) 
mult(a, b, c) 
mdiv(a, b, q, r) 
min(a) 
mout (a) 

pow(a, b, ra, c) 
gcd(a, b, c) 
rpow{a, b, c) 
msqrt(a, b, r) 
mint *a, *b, *c, 



*m, *q, *r; 



sdiv{a, n, q, r) 
mint *a, *q; 
short *r; 

mint *itom(n) 



DESCRIPTION 

These routines perform arithmetic on integers of arbitrary 
length. The integers are stored using the defined type 
mint . Pointers to a mint should be initialized using the 
function itom , which sets the initial value to n. After 
that space is managed automatically by the routines. 



madd , msub , 
difference, 
arguments, 
tively, to 
mdiv except 



mult, assign to their third arguments the sum, 
and product, respectively, of their first two 
mdiv assigns the quotient and remainder, respec- 
its third and fourth arguments, sdiv is like 
that the divisor is an ordinary integer. msqrt 
produces the square root and remainder of its first argu- 
ment, rpow calculates a raised to the power b, while pow 
calculates this reduced modulo m. min and mout do decimal 
input and output. 

The functions are obtained with the loader option - Imp . 

DIAGNOSTICS 

Illegal operations and running out of memory produce mes- 
sages and core images. 
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NAME 

nlist - get entries from name list 

SYNOPSIS 

# include <a.out.h> 
nlist(f ilenarae, nl) 
char *filename; 
struct nlist nl[ ] ; 

DESCRIPTION 

Nlist examines the name list in the given executable output 
file and selectively extracts a list of values. The name 
list consists of an array of structures containing names, 
types and values. The list is terminated with a null name. 
Each name is looked up in the name list of the file. If the 
name is found, the type and value of the name are inserted 
in the next two fields. If the name is not found, both 
entries are set to 0. See a. out (5) for the structure 
declaration. 

This subroutine is useful for examining the system name list 
kept in the file /unix. In this way programs can obtain 
system addresses that are up to date. 

SEE ALSO 

a.out(5) 

DIAGNOSTICS 

All type entries are set to if the file cannot be found or 
if it is not a valid namelist. 
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NAME 

perror, sys_errlist, sys_nerr - system error messages 

SYNOPSIS 

perror(s) 
char *s; 

int sys_nerr; 

char *sys_errlist[ ] ; 

DESCRIPTION 

Perror produces a short error message on the standard error 
file describing the last error encountered during a call to 
the system from a C program. First the argument string s is 
printed, then a colon, then the message and a new-lTne. 
Most usefully, the argument string is the name of the pro- 
gram which incurred the error. The error number is taken 
from the external variable errno (see intro (2) ) , which is 
set when errors occur but not cleared when non-erroneous 
calls are made. 

To simplify variant formatting of messages, the vector of 
message strings sys errlist is provided; errno can be used 
as an index in this table to get the message string without 
the newline. Sys nerr is the number of messages provided 
for in the table; it should be checked because new error 
codes may be added to the system before they are added to 
the table. 

SEE ALSO 

intro(2) 
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NAME 

pkopen, pkclose, pkread, pkwrite, pkfail - packet driver 
simulator 

SYNOPSIS 

char *pkopen ( f d ) 

pkclose(ptr) 
char *ptr; 

pkread (ptr, buffer, count) 
char *ptr, *buffer; 

pkwrite(ptr, buffer, count) 
char *ptr, *buffer; 

pkfailO 

DESCRIPTION 

These routines are a user-level implementation of the full- 
duplex end-to-end communication protocol described in pk(4). 
If fd is a file descriptor open for reading and writing, 
pkopen carries out the initial synchronization and returns 
an identifying pointer. The pointer is used as the first 
parameter to pkread , pkwrite , and pkclose . 

Pkread , pkwrite and pkclose behave analogously to read , 
write and close (2) . However, a write of zero bytes is mean- 
ingful and will produce a corresponding read of zero bytes. 

SEE ALSO 

pk(4), pkon(2) 

DIAGNOSTICS 

Pkfail is called upon persistent breakdown of communication. 

Pkfail must be supplied by the user. 

Pkopen returns a null (0) pointer if packet protocol can not 

be established. 

Pkread returns -1 on end of file, in correspondence with a 

0-length write. 

RESTRICTIONS 

The Packet Driver is not supported by the ULTRIX-11 operat- 
ing system. 

This simulation of gli^^) leaves something to be desired in 
needing special read and write routines, and in not being 
inheritable across calls of exec (2) . Its prime use is on 
systems that lack pk . 

These functions use alarm(2); simultaneous use of alarm for 
other puposes may cause trouble. 
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NAME 

plot: openpl et al. - graphics interface 

SYNOPSIS 

openpl ( ) 

erase{ ) 

label (s) char s[ ]; 

lineixl, yl, x2, y2) 

circle(x, y, r) 

arc(x, y, xO, yO , xl, yl) 

move ( X , y ) 

cont(x, y) 

point(x, y) 

linemod(s) char s[ ]; 

space(xO, yO, xl, yl) 

closepK ) 

DESCRIPTION 

These subroutines generate graphic output in a relatively 
device- independent manner. See plot (5) for a description of 
their effect. Openpl must be used before any of the others 
to open the device for writing. Closepl flushes the output. 

String arguments to label and linemod are null-terminated, 
and do not contain newlines. 

Various flavors of these functions exist for different out- 
put devices. They are obtained by the following ld(l) 
options: 

-Iplot device- independent graphics stream on standard out- 
put for plot (l) filters 
-lt300 GSI 300 terminal 
-lt300s GSI 300S terminal 
-lt450 DASI 450 terminal 
-lt4014 Tektronix 4014 terminal 

SEE ALSO 

plot(5), plot(l), graphd) 
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NAME 

popen, pclose - initiate I/O to/from a process 

SYNOPSIS 

#include <stdio.h> 

FILE *popen(conunand, type) 
char *conunand, *type; 

pclose (stream) 
FILE *streani; 

DESCRIPTION 

The arguments to popen are pointers to null-terminated 
strings containing respectively a shell command line and an 
I/O mode, either "r" for reading or "w" for writing. It 
creates a pipe between the calling process and the command 
to be executed. The value returned is a stream pointer that 
can be used (as appropriate) to write to the standard input 
of the command or read from its standard output. 

A stream opened by popen should be closed by pclose , which 
waits for the associated process to terminate and returns 
the exit status of the command. 

Because open files are shared, a type "r" command may be 
used as an input filter, and a type "w" as an output filter. 

SEE ALSO 

pipe(2), fopenO), fcloseO), systemO), wait(2) 

DIAGNOSTICS 

Popen returns a null pointer if files or processes cannot be 
created, or the Shell cannot be accessed. 

Pclose returns -1 if stream is not associated with a 
'popened' command. 

RESTRICTIONS 

Buffered reading before opening an input filter may leave 
the standard input of that filter mispositioned. Similar 
problems with an output filter may be forestalled by careful 
buffer flushing, e.g. with f flush , see fcloseO). 



printfOs) printfOs) 



NAME 

printf, fprintf, sprintf - formatted output conversion 

SYNOPSIS 

#include <stdio.h> 

printf (format [, arg ] ... ) 
char *format; 

fprintf (stream, format [, arg ] ) 

FILE *stream; 
char *format; 

sprintf (s, format [, arg ] ... ) 
char *s, format; 

DESCRIPTION 

Printf places output on the standard output stream stdout . 
Fprintf places output on the named output stream . Sprintf 
places 'output' in the string s, followed by the character 
■\0'. 

Each of these functions converts, formats, and prints its 
arguments after the first under control of the first argu- 
ment. The first argument is a character string which con- 
tains two types of objects: plain characters, which are sim- 
ply copied to the output stream, and conversion specifica- 
tions, each of which causes conversion and printing of the 
next successive arg printf . 

Each conversion specification is introduced by the character 
%. Following the %, there may be 

an optional minus sign '-' which specifies left adjust- 
ment of the converted value in the indicated field; 

an optional digit string specifying a field width; if 
the converted value has fewer characters than the field 
width it will be blank-padded on the left (or right, if 
the left-adjustment indicator has been given) to make 
up the field width; if the field width begins with a 
zero, zero-padding will be done instead of blank- 
padding; 

an optional period '.' which serves to separate the 
field width from the next digit string; 

an optional digit string specifying a precision which 
specifies the number of digits to appear after the 
decimal point, for e- and f-conversion, or the maximum 
number of characters to be printed from a string; 
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the character 1 specifying that a following d, o, x, or 
u corresponds to a long integer arg . (A capitalized 
conversion code accomplishes the same thing.) 

a character which indicates the type of conversion to 
be applied. 

A field width or precision may be '*' instead of a digit 
string. In this case an integer arg supplies the field 
width or precision. 

The conversion characters and their meanings are 

dox The integer arg is converted to decimal, octal, or hex- 
adecimal notation respectively. 

f The float or double arg is converted to decimal nota- 
tion in the style 'T-Tddd.ddd' where the number of d's 
after the decimal point is equal to the precision 
specification for the argument. If the precision is 
missing, 6 digits are given; if the precision is expli- 
citly 0, no digits and no decimal point are printed. 

e The float or double arg is converted in the style 
' [-]d.ddde+dd' where there is one digit before the 
decimal point and the number after is equal to the pre- 
cision specification for the argument; when the preci- 
sion is missing, 6 digits are produced. 

g The float or double arg is printed in style d, in style 
f, or in style e, whichever gives full precision in 
minimum space. 

c The character arg is printed. Null characters are 
ignored. 

s Arg is taken to be a string (character pointer) and 
characters from the string are printed until a null 
character or until the number of characters indicated 
by the precision specification is reached; however if 
the precision is or missing all characters up to a 
null are printed. 

u The unsigned integer arg is converted to decimal and 
printed (the result will be in the range to 65535). 

% Print a '%'; no argument is converted. 

In no case does a non-existent or small field width cause 
truncation of a field; padding takes place only if the 
specified field width exceeds the actual width. Characters 
generated by printf are printed by putc O) . 
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Examples 

To print a date and time in the form 'Sunday, July 3, 
10:02', where weekday and month are pointers to null- 
terminated strings: 

printf("%s, %s %d, %02d:%02d", weekday, month, day, 
hour, min); 

To print pi to 5 decimals: 

printfC'pi = %.5f", 4*atan(1.0) ) ; 

SEE ALSO 

putc(3), scanfO), ecvtO) 

RESTRICTIONS 

Very wide fields (>128 characters) fail. 
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NAME 

putc, putchar, fputc, putw - put character or word on a 
stream 

SYNOPSIS 

finclude <stdio.h> 

int putc(c, stream) 

char c; 

FILE *stream; 

putchar(c) 

fputc{c, stream) 
FILE *stream; 

putw(w, stream) 
FILE *stream; 

DESCRIPTION 

Putc appends the character c to the named output stream . It 
returns the character written. 

Putchar (c) is defined as putc (c, stdout) . 

Fputc behaves like putc , but is a genuine function rather 
than a macro. It may be used to save on object text. 

Putw appends word (i.e. int) w to the output stream . It 
returns the word written. Putw neither assumes nor causes 
special alignment in the file. 

The standard stream stdout is normally buffered if and only 
if the output does not refer to a terminal; this default may 
be changed by setbuf (3) . The standard stream stderr is by 
default unbuffered unconditionally, but use of freopen (see 
fopen (3) ) will cause it to become buffered; setbuf , again, 
will set the state to whatever is desired. When an output 
stream is unbuffered information appears on the destination 
file or terminal as soon as written; when it is buffered 
many characters are saved up and written as a block. Ff lush 
(see fclose (3) ) may be used to force the block out early. 



SEE ALSO 

fopen(3), fclose(3), getc(3), puts(3), printf(3), fread(3) 

DIAGNOSTICS 

These functions return the constant EOF upon error. Since 
this is a good integer, ferror (3) should be used to detect 
putw errors. 
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RESTRICTIONS 

Because it is implemented as a macro, putc treats a stream 
argument with side effects improperly. in particular 
putc(c, *f++);' doesn't work sensibly. 
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NAME 

puts, fputs - put a string on a stream 

SYNOPSIS 

#include <stdio.h> 

puts(s) 
char *s; 

fputs(s, stream) 
char *s; 
FILE *stream; 

DESCRIPTION 

Puts copies the null-terminated string s to the standard 
output stream stdout and appends a newline character. 

Fputs copies the null-terminated string s to the named out- 
put stream. 

Neither routine copies the terminal null character. 

SEE ALSO 

fopenO), getsO), putcO), printfO), ferrorO) 
freadO) for fwrite 

RESTRICTIONS 

Puts appends a newline, fputs does not, all in the name of 
backward compatibility. 
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NAME 

qsort - quicker sort 

SYNOPSIS 

qsort (base, nel, width, compar) 

char *base; 

int {*compar)( ); 

DESCRIPTION 

Qsort is an implementation of the quicker-sort algorithm. 
The first argument is a pointer to the base of the data; the 
second is the number of elements; the third is the width of 
an element in bytes; the last is the name of the comparison 
routine to be called with two arguments which are pointers 
to the elements being compared. The routine must return an 
integer less than, equal to, or greater than according as 
the first argument is to be considered less than, equal to, 
or greater than the second. 

SEE ALSO 

sort(l) 
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NAME 

rand, srand - random number generator 

SYNOPSIS 

srand(seed) 
int seed; 

rand( ) 

DESCRIPTION 

Rand uses a multiplicative congruential random number gen- 
erator with period 232 to return successive pseudo-random 
numbers in the range from to 215-1. 

The generator is reinitialized by calling srand with 1 as 
argxament. It can be set to a random starting point by cal- 
ling srand with whatever you like as argument. 
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NAME 

scanf, fscanf, sscanf - formatted input conversion 

SYNOPSIS 

tinclude <stdio.h> 

scanf (format [ , pointer 3 . . . ) 
char *format; 

fscanf (stream, format [ , pointer ] . . . ) 
FILE *stream; 
char *format; 

sscanf(s, format [ , pointer ] . . . ) 
char *s, *format; 

DESCRIPTION 

Scanf reads from the standard input stream stdin. Fscanf 
reads from the named input stream . Sscanf reads from the 
character string s. Each function reads characters, inter- 
prets them according to a format, and stores the results in 
its arguments. Each expects as arguments a control string 
format , described below, and a set of pointer arguments 
indicating where the converted input should be stored. 

The control string usually contains conversion specifica- 
tions, which are used to direct interpretation of input 
sequences. The control string may contain: 

1. Blanks, tabs or newlines, which match optional white 
space in the input. 

2. An ordinary character (not %) which must match the next 
character of the input stream. 

3. Conversion specifications, consisting of the character 
%, an optional assignment suppressing character *, an 
optional numerical maximum field width, and a conversion 
character. 

A conversion specification directs the conversion of the 
next input field; the result is placed in the variable 
pointed to by the corresponding argument, unless assignment 
suppression was indicated by *. An input field is defined 
as a string of non-space characters; it extends to the next 
inappropriate character or until the field width, if speci- 
fied, is exhausted. 

The conversion character indicates the interpretation of the 
input field; the corresponding pointer argument must usually 
be of a restricted type. The following conversion charac- 
ters are legal: 
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% a single '%' is expected in the input at this point; no 
assignment is done. 

d a decimal integer is expected; the corresponding argu- 
ment should be an integer pointer. 

o an octal integer is expected; the corresponding argument 
should be a integer pointer. 

X a hexadecimal integer is expected; the corresponding 
argument should be an integer pointer. 

s a character string is expected; the corresponding argu- 
ment should be a character pointer pointing to an array 
of characters large enough to accept the string and a 
terminating '\0', which will be added. Tl\e input field 
is terminated by a space character or a newlThe. 

c a character is expected; the corresponding argument 
should be a character pointer. The normal skip over 
space characters is suppressed in this case; to read the 
next non-space character, try '%ls'. If a field width 
is given, the corresponding argument should refer to a 
character array, and the indicated number of characters 
is read. 

e f a floating point number is expected; the next field is 
converted accordingly and stored through the correspond- 
ing argument, which should be a pointer to a float . The 
input format for floating point numbers is an optionally 
signed string of digits possibly containing a decimal 
point, followed by an optional exponent field consisting 
of an E or e followed by an optionally signed integer. 

[ indicates a string not to be delimited by space charac- 
ters. The left bracket is followed by a set of charac- 
ters and a right bracket; the characters between the 
brackets define a set of characters making up the 
string. If the first character is not circumflex {^), 
the input field is all characters until the first char- 
acter not in the set between the brackets; if the first 
character after the left bracket is ^, the input field 
is all characters until the first character which is in 
the remaining set of characters between the brackets. 
The corresponding argument must point to a character 
array. 

The conversion characters d, o and x may be capitalized or 
proceeded by 1 to indicate that a pointer to long rather 
than to int is in the argument list. Similarly, the conver- 
sion characters e or f may be capitalized or preceded by 1 
to indicate a pointer to double rather than to float. The 
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conversion characters d, o and x may be preceeded by h to 
indicate a pointer to short rather than to int. 

The scanf functions return the number of successfully 
matched and assigned input items. This can be used to 
decide how many input items were found. The constant EOF is 
returned upon end of input; note that this is different from 
0, which means that no conversion was done; if conversion 
was intended, it was frustrated by an inappropriate charac- 
ter in the input. 

For example, the call 

int i; float x; char name[50]; 
scanf ( "%d%f%s", &i, &x, name); 

with the input line 

25 54.32E-1 thompson 

will assign to i the value 25, x the value 5.432, and name 
will contain ' thompsonXO ' . Or, 

int i; float x; char name[50]; 

scanf ("%2d%f%*d%[1234567890]", &i, Sx, name); 

with input 

56789 0123 56a72 

will assign 56 to J^, 789.0 to x, skip '0123', and place the 
string '56\0' in name. The next call to getchar will return 
• a ' . 

SEE ALSO 

atof{3), getc{3), printf{3) 

DIAGNOSTICS 

The scanf functions return EOF on end of input, and a short 
count for missing or illegal data items. 

RESTRICTIONS 

The success of literal matches and suppressed assignments is 
not directly determinable. 
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NAME 

setbuf - assign buffering to a stream 

SYNOPSIS 

finclude <stdio.h> 

setbuf (stream, buf) 
FILE *stream; 
char *buf; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it 
IS read or written. It causes the character array buf to be 
used instead of an automatically allocated buffer. If buf 
is the constant pointer NULL, input/output will be coriP 
pletely unbuffered. 

A manifest constant BUFSIZ tells how big an array is needed: 

char buf [BUFSIZ]; 

A buffer is normally obtained from malloc O) upon the first 
getc or putc (3) on the file, except that output streams 
directed to terminals, and the standard error stream stderr 
are normally not buffered. 

SEE ALSO 

fopenO), getc(3), putc(3), mallocO) 
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NAME 

setjmp, longjmp - non-local goto 

SYNOPSIS 

#include <setjmp.h> 

set jmp(env) 
jmp_buf env; 

longjmp (env, val) 
jnip_buf env; 

DESCRIPTION 

These routines are useful for dealing with errors and inter- 
rupts encountered in a low-level subroutine of a program. 

Setjmp saves its stack environment in env for later use by 
longjmp . It returns value 0. 

Longjmp restores the environment saved by the last call of 
setjmp . It then returns in such a way that execution con- 
tinues as if the call of setjmp had just returned the value 
val to the function that invoked setjmp , which must not 
Itself have returned in the interim. All accessible data 
have values as of the time longjmp was called. 

SEE ALSO 

signal{2) 
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NAME 

sigset, signal, sighold, sigignore, sigrelse, sigpause 
manage signals 

SYNOPSIS 

#include <signal.h> 

void action( ) ; 

int action{); (ij^ void is not supported ) 

int sig; 

sigset(sig, action) 
signaKsig, action) 

sighold(sig) 

sigignore(sig) 

sigrelse(sig) 

sigpause (sig) 

cc ... -Ijobs 

DESCRIPTION 

This is a package of signal management functions to manage 
the signals as described in sigsys (2J) . These functions are 
not available in most versions of UNIX, and should not be 
used when the mechanisms of signal (2) would suffice, as they 
would then impair portability. These functions are con- 
tained in the jobs library, obtained by specifying the 
loader option -Ijobs. 

Sigset is used to provide a default signal handler for sig- 
nal sig . This function is remembered across subsequent calls 
to the other functions, and need not be specified again. 
After sigset instances of sig will cause an interrupt to be 
taken at func, with the signal then held so that recursive 
trapping due to the signal will not occur. During normal 
return from func, the routines arrange for the signal action 
to be restored so that subsequent signals will also trap to 
func . If a non-local exit is to be taken, then sigrelse must 
be called to un-hold the signal action, restoring the origi- 
nal catch. Func may also be specified as SIG_DFL, SIG_IGN 
or SIG_HOLD, as described in sigsys (2J) . The value speci- 
fied on the previous call to sigset is returned; if sigset 
has never been called, then the default action inherited 
from the system is returned. 

Signal is like sigset, but the signal will not be held when 
the action routine is called; rather it will have reverted 
to SIG_DFL. This is generally unsafe, but is included for 
backwards compatibility to the old signal mechanism. It 
should not be used. 
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Sighold and siqrelse may be used to block off sig in a piece 
of code where it cannot be tolerated. After sigrelse the 
catch initially set with sigset will be restored. 

Sigignore can be used to temporarily set the action for sig 
to ignore the signal. If the signal had been held before 
the call to sigignore , any pending instance of the signal 
will be discarded. 

Sigpause may be used by a routine which wishes to check for 
some condition produced at interrupt level by the sig sig- 
nal, and then to pause waiting for the condition to arise 
with the catch of the signal enabled. In correct usage it 
must be preceded by an instance of sighold to block the sig- 
nal. Sigpause is like pause in that it will return after 
any signal is processed. The usual thing to do then is to 
reenable the hold with sighold , check the condition again, 
and sigpause again if the condition has not arisen. 

SEE ALSO 

signal(2), sigsys(2J), intro(3J), tty(4) 

RESTRICTIONS 

Sighold and sigrelse do not nest; the first sigrelse 
restores the default catch. 

These functions store information in data space. You thus 
must call sigsys (2J) rather than any of sigset or signal 
after a vfork(2) in the child which is to then exec. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 - trigonometric func- 
tions 

SYNOPSIS 

#include <math.h> 

double sin(x) 
double x; 

double cos(x) 
double x; 

double asin{x) 
double x; 

double acos(x) 
double x; 

double atan(x) 
double x; 

double atan2(x, y) 
double X, y; 

DESCRIPTION 

Sin , cos and tan return trigonometric functions of radian 
arguments. The magnitude of the argument should be checked 
by the caller to make sure the result is meaningful. 

Asin returns the arc sin in the range -pi/2 to pi/2. 

Acos returns the arc cosine in the range to pi. 

Atan returns the arc tangent of x in the range -pi/2 to 
pTTI. 

Atan2 returns the arc tangent of x/^ in the range -pi to pi. 

DIAGNOSTICS 

Arguments of magnitude greater than 1 cause asin and acos to 
return value 0; errno is set to EDOM. The value of tan at 
its singular points is a huge number, and errno is set to 
ERANGE. 

RESTRICTIONS 

The value of tan for arguments greater than about 2**31 is 
garbage. 
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NAME 

sinh, cosh, tanh - hyperbolic functions 

SYNOPSIS 

# include <math.h> 

double sinh(x) 
double x; 

double cosh{x) 
double x; 

double tanh(x) 
double x; 

DESCRIPTION 

These functions compute the designated hyperbolic functions 
for real argxaments. 

DIAGNOSTICS 

Sinh and cosh return a huge value of appropriate sign when 
the correct value would overflow. 
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NAME 



sleep - suspend execution for interval 



SYNOPSIS 

sleep (seconds) 
unsigned seconds; 

DESCRIPTION 

The current process is suspended from execution for the 

number of seconds specified by the argioment. The actual 

suspension time may be up to 1 second less than that 
requested, because scheduled wakeups occur at fixed 1-second 

intervals, and an arbitrary amount longer because of other 
activity in the system. 

The routine is implemented by setting an alarm clock signal 
and pausing until it occurs. The previous state of this 
signal is saved and restored. If the sleep time exceeds the 
time to the alarm signal, the process sleeps only until the 
signal would have occurred, and the signal is sent 1 second 
later. 



SEE ALSO 

alarm(2), pause{2) 
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NAME 

stdio - standard buffered input/output package 

SYNOPSIS 

finclude <stdio.h> 
FILE *stdin; 
FILE *stdout; 
FILE *stderr; 

DESCRIPTION 

The functions described in Sections 3S constitute an effi- 
cient user-level buffering scheme. The in-line macros getc 
and putc (3) handle characters quickly. The higher level 
routines gets , fgets , scanf , fscanf, fread, puts , fputs , 
printf , fprintf , fwrite all use getc and putc ; they can be 
freely intermixed. 

A file with associated buffering is called a stream , and is 
declared to be a pointer to a defined type FILE. Fopen Q) 
creates certain descriptive data for a stream and returns a 
pointer to designate the stream in all further transactions. 
There are three normally open streams with constant pointers 
declared in the include file and associated with the stan- 
dard open files: 

stdin standard input file 
stdout standard output file 
stderr standard error file 

A constant 'pointer' NULL (0) designates no stream at all. 

An integer constant EOF (-1) is returned upon end of file or 
error by integer functions that deal with streams. 

Any routine that uses the standard input/output package must 
include the header file <stdio.h> of pertinent macro defini- 
tions. The functions and constants mentioned in sections 
labeled 3S are declared in the include file and need no 
further declaration. The constants, and the following 
'functions' are implemented as macros; redeclaration of 
these names is perilous: getc, getchar , putc , putchar , feof, 
f error , f ileno . 

SEE ALSO 

open{2), close(2), read(2), write(2) 

DIAGNOSTICS 

The value EOF is returned uniformly to indicate that a FILE 
pointer has not been initialized with fopen , input (output) 
has been attempted on an output (input) stream, or a FILE 
pointer designates corrupt or otherwise unintelligible FILE 
data. 
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NAME 

strcat, strncat, strcmp, strncmp, strcpy, strncpy, strlen, 
index, rindex - string operations 

SYNOPSIS 

char *strcat(sl, s2) 
char *sl, *s2; 

char *strncat(sl, s2, n) 
char *sl, *s2; 

strcmp(sl, s2) 
char *sl, *s2; 

strncmp(sl, s2, n) 
char *sl, *s2; 

char *strcpy(sl, s2) 
char *sl, *s2; 

char *strncpy(sl, s2, n) 
char *sl, *s2; 

strlen{s) 
char *s; 

char *index(s, c) 
char *s, c; 

char *rindex(s, c) 
char *s; 

DESCRIPTION 

These functions operate on null-terminated strings. They do 
not check for overflow of any receiving string. 

Strcat appends a copy of string s2 to the end of string si. 
Strncat copies at most n characters. Both return a pointer 
to the null-terminated result. 

Strcmp compares its arguments and returns an integer greater 
than, equal to, or less than 0, according as si is lexico- 
graphically greater than, equal to, or less than s2. 
Strncmp makes the same comparison but looks at at most n 
characters. 

Strcpy copies string s2 to si, stopping after the null char- 
acter has been moved. Strncpy copies exactly n characters, 
truncating or null-padding s2; the target may not be null- 
terminated if the length of s2 is n or more. Both return 
si. 
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Strlen returns the number of non-null characters in s. 

Index ( rindex ) returns a pointer to the first (last) 
occurrence of character c in string s, or zero if c does not 
occur in the string. ~ 

RESTRICTIONS 

Strcmp uses native character comparison, which is signed on 
PDPll's, unsigned on other machines. 



SWAB(3) SWAB(3) 



NAME 

swab - swap bytes 

SYNOPSIS 

swab (from, to, nbytes) 
char *from, *to; 

DESCRIPTION 

Swab copies nbytes bytes pointed to by from to the position 
pointed to by to, exchanging adjacent even and odd bytes. 
It is useful for carrying binary data between PDPll's and 
other machines. Nbytes should be even. 
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NAME 

system - issue a shell command 

SYNOPSIS 

system(string) 
char *string; 

DESCRIPTION 

System causes the string to be given to sh(l) as input as if 
the string had been typed as a command at a terminal. The 
current process waits until the shell has completed, then 
returns the exit status of the shell. 

SEE ALSO 

popenO), exec(2), wait (2) 

DIAGNOSTICS 

Exit status 127 indicates the shell couldn't be executed. 
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NAME 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal 
independent operation routines 

SYNOPSIS 

char PC; 
char *BC; 
char *UP; 
short ospeed; 

tgetent(bp, name) 
char *bp, *name; 

tgetnum( id) 
char *id; 

tgetf lag( id) 
char *id; 

char * 

tgetstr(id, area) 
char *id, **area; 

char * 

tgoto(cm, destcol, destline) 

char *cm; 

tputs(cp, affcnt, outc) 
register char *cp; 
int affcnt; 
int (*outc)(); 

DESCRIPTION 

These functions extract and use capabilities from the termi- 
nal capability data base termcap (5) . These are low level 
routines; see cursesO) for a higher level package. 

Tgetent extracts the entry for terminal name into the buffer 
^^ 1°£.' §E should be a character buffer of size 1024 and must 
be retained through all subsequent calls to tgetnum , tget- 
flag , and tgetstr . Tgetent returns -1 if it cannot open the 
termcap file, if the terminal name given does not have an 
entry, and 1 if all goes well. It will look in the environ- 
ment for a TERMCAP variable. If found, and the value does 
not begin with a slash, and the terminal type name is the 
same as the environment string TERM, the TERMCAP string is 
used instead of reading the termcap file. If it does begin 
with a slash, the string is used as a path name rather than 
/etc/ termcap . This can speed up entry into programs that 
call tgetent , as well as to help debug new terminal descrip- 
tions or to make one for your terminal if you can't write 
the file /e tc / termcap . 
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Tgetnum gets the numeric value of capability id, returning 
-1 if is not given for the terminal. Tgetf lag returns 1 if 
the specified capability is present in the terminal's entry, 
if it is not. Tgetstr gets the string value of capability 
id , placing it in the buffer at area , advancing the area 
pointer. It decodes the abbreviations for this field 
described in termcap (5) , except for cursor addressing and 
padding information. 

Tgoto returns a cursor addressing string decoded from cm to 
go to column destcol in line destline . It uses the external 
variables UP (from the up capability) and BC (if be is given 
rather than bs) if necessary to avoid placing \n, -^D or ^Q 
in the returned string. (Programs which call tgoto should 
be sure to turn off the XTABS bit(s), since tgoto may now 
output a tab. Note that programs using termcap should in 
general turn off XTABS anyway since some terminals use con- 
trol I for other functions, such as nondestructive space.) 
If a % sequence is given which is not understood, then tgoto 
returns "OOPS". 

Tputs decodes the leading padding information of the string 
cp ; af fcnt gives the number of lines affected by the opera- 
tion, or 1 if this is not applicable, outc is a routine 
which is called with each character in turn. The external 
variable ospeed should contain the output speed of the ter- 
minal as encoded by stty (2) . The external variable PC 
should contain a pad character to be used (from the pc capa- 
bility) if a null (^@) is inappropriate. 

FILES 

/usr/lib/libtermlib.a -Itermlib library 
/etc/termcap data base 

SEE ALSO 

ex(l), cursesO), termcap(5) 

AUTHOR 

William Joy 

RESTRICTIONS 
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NAME 

ttyname, isatty, ttyslot - find name of a terminal 

SYNOPSIS 

char *ttyname(f ildes) 

isatty(f ildes) 

ttyslotO 

DESCRIPTION 

Ttyname returns a pointer to the null-terminated path name 
of the terminal device associated with file descriptor 
f ildes . 

Isatty returns 1 if f ildes is associated with a terminal 
device, otherwise. 

Ttyslot returns the number of the entry in the ttys (5) file 
for the control terminal of the current process. 

FILES 

/dev/* 
/etc/ttys 

SEE ALSO 

ioctl(2), ttys(5) 

DIAGNOSTICS 

Ttyname returns a null pointer (0) if f ildes does not 
describe a terminal device in directory '/dev'. 

Ttyslot returns if '/etc/ttys' is inaccessible or if it 
cannot determine the control terminal. 

RESTRICTIONS 

The return value points to static data whose content is 
overwritten by each call. 
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NAME 

ungetc - push character back into input stream 

SYNOPSIS 

#include <stdio.h> 

ungetc(c, stream) 
FILE *stream; 

DESCRIPTION 

Ungetc pushes the character c back on an input stream. That 
character will be returned by the next getc call on that 
stream. Ungetc returns c. 

One character of pushback is guaranteed provided something 
has been read from the stream and the stream is actually 
buffered. Attempts to push EOF are rejected. 

Fseek (3) erases all memory of pushed back characters. 

SEE ALSO 

getc(3), setbuf(3), fseek(3) 

DIAGNOSTICS 

Ungetc returns EOF if it can't push a character back. 
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NAME 

cat - phototypesetter interface 

DESCRIPTION 

Cat provides the interface to a Graphic Systems C/A/T photo- 
typesetter, via DRll-C general device interface. Bytes 
written on the file specify font, size, and other control 
information as well as the characters to be flashed. The 
coding will not be described here. 

Only one process may have this file open at a time. It is 
write-only. 

FILES 

/dev/cat 

SEE ALSO 

troff(l) 

Phototypesetter interface specification 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

RESTRICTIONS 

The C/A/T interface is only partially supported by ULTRIX- 
11, i.e., data written to the /dev/cat file will be 
presented at the output cable of the DRll-C. 
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NAME 

dh, dz - DHll/DHUll/DHVll and DZll/DZVll/DZQll asynchronous 
multiplexers dhdm - DMll-BB (modem controller for DHll) 

DESCRIPTION 

Each line attached to a DHll, DZll, DZVll, or DZQll communi- 
cations multiplexer behaves as described in tty (4). Input 
and output for each line may independently be set to run at 
any of 16 speeds; see tty (4) for encoding. For DZll, DZVll 
and DZQll lines, the output speed always equals the input 
speed. The 200 speed and the two externally clocked speeds 
(exta, extb) are missing on the DZll, DZVll and DZQll. The 
50 speed and extb are not allowed on the DHUll and DHVll. 

The DHll and DHUll have 16 lines, the DZll and DHVll have 8 
lines, and the DZVll and DZQll have four lines. The DHVll, 
DZVll and DZQll are used only on Q bus processors. 

FILES 

/dev/tty## 

SEE ALSO 

tty(4), getty(8) 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 



DN(4) DN(4) 



NAME 

dn - DN-11 ACU interface 

DESCRIPTION 

The dn# files are write-only. The permissible codes are: 

0-9 dial 0-9 
: dial * 

dial # 

4 second delay for second dial tone 
< end-of-niimber 

The entire telephone number must be presented in a single 
write system call. 

It is recommended that an end-of-niomber code be given even 
though not all ACU's actually require it. 

FILES 

/dev/dnO connected to 801 with dpO 

/dev/dnl not currently connected 

/dev/dn2 not currently connected 

SEE ALSO 

du(4) 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

The DN-11 is obsolete and is not supported by ULTRIX-11. 
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NAME 

du, dp - DU-11 201 data-phone interface 

DESCRIPTION 

The dpO file is a 201 data-phone interface. Read and write 
calls to dpO are limited to a maximiam of 512 bytes. Each 
write call is sent as a single record. Seven bits from each 
byte are written along with an eighth odd parity bit. The 
sync must be user supplied. Each read call returns charac- 
ters received from a single record. Seven bits are returned 
unaltered; the eighth bit is set if the byte was not 
received in odd parity. A 10 second time out is set and a 
zero-byte record is returned if nothing is received in that 
time. 

The unibus interrupt request priority level for the DU-11 
must be set to BR 6. 

FILES 

/dev/dpO 
/dev/du# 

SEE ALSO 

dn(4) 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

The DU-11 is obsolete and is not supported by ULTRIX-11. 
The name dpO is a historical dreg. 
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NAME 

dh, dz - DHll/DHUll/DHVll and DZll/DZVll/DZQll asynchronous 
multiplexers dhdm - DMll-BB (modem controller for DHll) 

DESCRIPTION 

Each line attached to a DHll, DZll, DZVll, or DZQll communi- 
cations multiplexer behaves as described in tty (4). Input 
and output for each line may independently be set to run at 
any of 16 speeds; see tty (4) for encoding. For DZll, DZVll 
and DZQll lines, the output speed always equals the input 
speed. The 200 speed and the two externally clocked speeds 
(exta, extb) are missing on the DZll, DZVll and DZQll. The 
50 speed and extb are not allowed on the DHUll and DHVll. 

The DHll and DHUll have 16 lines, the DZll and DHVll have 8 
lines, and the DZVll and DZQll have four lines. The DHVll, 
DZVll and DZQll are used only on Q bus processors. 

FILES 

/dev/tty## 

SEE ALSO 

tty(4), getty(8) 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 
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NAME 

hk - RK611/RK06, RK07 moving-head disk 

DESCRIPTION 

The RK611/RK711 controller supports up to eight RK06/RK07 
disk drives. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for information about logical disk names and Appendix D for 
disk partition sizes. 

The hk files access the disk via the system's normal buffer- 
ing mechanism and may be read and written without regard to 
physical disk records. 

A 'raw' interface provides for direct transmission between 
the disk and the user's read or write buffer. A single read 
or write call results in exactly one I/O operation and 
therefore raw I/O is considerably more efficient when many 
words are transmitted. The names of the raw files conven- 
tionally begin with an extra 'r.' In raw I/O the buffer must 
begin on a word boundary. 

FILES 

/dev/hk##, /dev/rhk## 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 
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ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O read and write (2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read , write and lseek(2) should always 
deal in 512-byte multiples. 
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NAME 

hp - First RH11/RH70 massbus disk controller 
hm - Second RH11/RH70 massbus disk controller 
hj - Third RH11/RH70 massbus disk controller 

DESCRIPTION 

The HP disk driver supports a heterogeneous mix of up to 
eight RM02/3/5, RP04/5/6, and MLll disks on the first 
RH11/RH70 controller, normally addressed at 0776700. The HM 
driver supports an identical mix of disks on the second and 
third RH11/RH70 controllers, addressed at 0776300 and 
0776400 respectively. The RM03 and RM05 disks may not be 
used with the RHll controller because their transfer rates 
exceed the bandwidth of the unibus. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for information about logical disk names and Appendix D for 
disk partition sizes. 

The MLll may be used for the swap device or perhaps mounted 
on /tmp. The MLll has switch-selectable transfer rates of 
0.25 mb, 0.5 mb, 1.0 mb, and 2.0 mb per second. The follow- 
ing transfer rate restrictions apply: 

0.25 mb all CPU's 

0.5 mb all CPU's 

1.0 mb PDP 11/70 with RH70 only 

2.0 mb NO PDPll CPU's 

The h£ and hm files access the disk via the system's normal 
buffering mechanism and may be read and written without 
regard to physical disk records. A 'raw' interface provides 
for direct transmission between the disk and the user's read 
or write buffer. A single read or write call results in 
exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The 
names of the raw files conventionally begin with an extra 
'r.' In raw I/O the buffer must begin on a word boundary. 

F ILES 

/dev/hp##, /dev/rhp## 
/dev/hm##, /dev/rhm## 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 
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RESTRICTIONS 

In raw I/O read and vrite (2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read , write and lseek (2) should always 
deal in 512-byte multiples. 



HS(4) HS(4) 



NAME 

hs - RH11/RH70 - RS03, RS04 fixed-head disk 

DESCRIPTION 

The files rsO ... rs7 refer to RS03 disk drives through 7. 
The files hsO ... hs7 refer to RS04 disk drives through 7. 
The RS03 drives are each 1024 blocks long and the RS04 
drives are 2048 blocks long. 

The hs and rs files access the disk via the system's normal 
buffering mechanism and may be read and written without 
regard to physical disk records. 

There is also a 'raw' interface which provides for direct 
transmission between the disk and the user's read or write 
buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the 
raw HS files begin with rhs . The same minor device con- 
siderations hold for the raw interface as for the normal 
interface. In raw I/O the buffer must begin on a word boun- 
dary. 

FILES 

/dev/rx#, /dev/rrs# 
/dev/hs#, /dev/rhs# 

SEE ALSO 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

This device is obsolete and, although a driver is provided, 
is not supported by ULTRIX-11. 

In raw I/O read and write (2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read , write and lseek (2) should always 
deal in 512-byte multiples. 
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NAME 

ht - RH11/RH70 - TM02/3 magtape controller 

DESCRIPTION 

Each TM02/3 magtape controller supports up to eight 

TU16/TE16/TU77 tape drives. Eight TM02/3 controllers may be 

connected to a single RHll or RH70 massbus controller. 

When opened for reading or writing, the tape is not rewound. 
When closed, it is rewound (unless the 0200 bit is on, see 
below). If the tape was open for writing, a double end-of- 
file is written. If the tape is not to be rewound the tape 
is backspaced to just between the two tapemarks. 

A standard tape consists of a series of 512 byte records 
terminated by a double end-of-file. To the extent possible, 
the system makes it possible, if inefficient, to treat the 
tape like any other file. Seeks have their usual meaning 
and it is possible to read or write a byte at a time. Writ- 
ing in very small units is inadvisable, however, because it 
tends to create monstrous record gaps. 

The last octal digit of the minor device number selects the 
drive. The middle digit selects a controller. The initial 
digit is even to select 1600 BPI, odd to select 800 BPI. If 
the 0200 bit is on (initial digit 2 or 3), the tape is not 
rewound on close. Note that the minor device number has no 
necessary connection with the file name. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for more information about logical device names. 

The mt files discussed above are useful when it is desired 
to access the tape in a way compatible with ordinary files. 
When foreign tapes are to be dealt with, and especially when 
long records are to be read or written, the 'raw' interface 
is appropriate. The associated files may be named rmtO, 
..., rmt7 , but the same minor-device considerations as for 
the regular files still apply. 

Each read or write call reads or writes the next record on 
the tape. In the write case the record has the same length 
as the buffer given. During a read, the record size is 



passed back as the number of bytes read, provided it is no 
greater than the buffer size; if the record is long, an 
error is indicated. In raw tape I/O, the buffer must begin 
on a word boundary and the count must be even. Seeks are 
ignored. A zero count is returned when a tape mark is read; 
another read will fetch the first record of the next tape 
file. 
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FILES 

/dev/mtf , /dev/rmt# , /dev/nrmt# 
/dev/ht#, /dev/rht#, /dev/nrht# 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

The magtape system is supposed to be able to take 64 drives. 
Such addressing has never been tried. 

Taking a drive off line, or running off the end of tape, 
while writing have been known to hang the system. 

If any non-data error is encountered, it refuses to do any- 
thing more until closed. In raw I/O, there should be a way 
to perform forward and backward record and file spacing and 
to write an EOF mark explicitly. 
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NAME 



hx - RX211/RX02 floppy disk 



DESCRIPTION 

HX ? refers to an entire disk as a single sequentially- 
addressed file. The physical disk sector size is 128 bytes 
for single density and 256 bytes for double density, the 
logical block size is 512 bytes. Each diskette has 500 log- 
ical blocks, single density and 1001 logical blocks, double 
density. The minor device numbers have the following signi- 
ficance: 

name minor device unit density format 



hxO 








single 


interleaved 


hxl 


1 


1 


single 


interleaved 


hx2 


2 





double 


interleaved 


hx3 


3 


1 


double 


interleaved 


hx4 


4 





single 


physical 


hx5 


5 


1 


single 


physical 


hx6 


6 





double 


physical 


hx7 


7 


1 


double 


physical 


hx8 


8 





single 


extended 


hx9 


9 


1 


single 


extended 



Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for more information about logical disk names and Appendix D 
for disk sizes. 



The hx files discussed above access the disk via the 
system's normal buffering mechanism and may be read and 
written without regard to physical disk records. There is 
also a 'raw' interface which provides for direct transmis- 
sion between the disk and the user's read or write buffer. 
A single read or write call results in exactly one I/O 
operation and therefore raw I/O is considerably more effi- 
cient when many words are transmitted. The names of the raw 
HX files begin with rhx and end with a number which selects 
the same disk as the corresponding hx file. 

In raw I/O the buffer must begin on a word boundary, and 
counts should be a multiple of 512 bytes (a disk block). 
Likewise seek calls should specify a multiple of 512 bytes. 

A logical 512 byte block is made up of four physical sectors 
on the single density devices, and two physical sectors on 
the double density devices. The four 'physical' device 
names are a straight mapping from the logical block number 
to the physical sectors, thus logical block maps to track 
0, sectors 1-2 for double density, and track 0, sectors 1-4 
for single density. This is not very efficient, since the 
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controller spends most of it's time waiting for the disk to 
get into position. The four 'interleaved' devices map logi- 
cal blocks to every other sector in the track. In addition, 
there is a six sector slew between tracks. Thus, logical 
block would be track 1, sectors 1, 3, 5 and 7 for single 
density, and sectors 1 and 3 for double density. Note that 
the 'interleaved' devices start with track 1, go to track 
76, and then to track 0, where as the 'physical' devices 
start with track 0. 

There are a total of 2002 sectors on a floppy, which for 
single density is a total of 500.5 512 byte blocks. The 
'interleaved' devices ignore the last half block (track 0, 
sectors 24 and 26). This last half block can be accessed by 
using the 'extended' devices, which have a size of 501 
blocks. When writing block 501, only the first 256 bytes 
will be written, the rest is discarded. When reading block 
501, the last 256 bytes are guaranteed to be nulls. These 
devices are intended for floppy image copies only, and 
should NOT be used for normal filesystems. 

FILES 

/dev/hx#, /dev/rhx# 

SEE ALSO 

rx2fmt(l) 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O read and write(2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read, write and lseek (2) should always 
deal in 512-byte multiples. 
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NAME 

Ip - line printer 

DESCRIPTION 

Lp provides the interface to any of the standard Digital 
Equipment Corporation line printers, on an LP-11 parallel 
interface. Bytes written are printed. 

The driver has several internal parameters for adapting to 
the characteristics of various printers. These parameters 
are settable, via ioctl(2) call, using the Ipset(l) command. 

The FFCLOSE parameter causes one page eject on close. The 
default is no page eject on close, because the line printer 
spooler does a page eject after each file is printed. No 
page eject is done on open. 

The CAP parameter determines whether or not the device is 
treated as having a 96- or 64-character set. In half-ASCII 
mode, lower case letters are turned into upper case and cer- 
tain characters are escaped according to the following 
table: 

{ 4 
} > 

I + 

The driver correctly interprets carriage returns, back- 
spaces, tabs, and form-feeds. A new-line that extends over 
the end of a page is turned into a form-feed. The default 
line length is 132 characters, indent is characters and 
lines per page is 66. These parameters are also settable by 
Ipset(l). Lines longer than the line length minus the 
indent are truncated. 

FILES 

/dev/lp 

SEE ALSO 

Ipr(l), Ipset(l) 

RESTRICTIONS 

Only a single LPll line printer controller is supported. 
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NAME 

mem, kmem - core memory 

DESCRIPTION 

Mem is a special file that is an image of the core memory of 
the computer. It may be used, for example, to examine, and 
even to patch the system. Kmem is the same as mem except 
that kernel virtual memory rather than physical memory is 
accessed. 

Byte addresses are interpreted as memory addresses. Refer- 
ences to non-existent locations return errors. 

Examining and patching device registers is likely to lead to 
unexpected results when read-only or write-only bits are 
present. 

On PDPll's, the I/O page begins at location 0160000 of kmem 
and per-process data for the current process begins at 
0140000. 

FILES 

/dev/mem, /dev/kmem 

RESTRICTIONS 

On PDPll's, memory files are accessed one byte at a time, an 
inappropriate method for some device registers. 
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NAME 

ml - RH11/RH70 - MLll solid state disk 

DESCRIPTION 

The ML driver supports up to eight MLll disk units on a 
separate RHll or RH70 massbus disk controller. If the MLll 
is mixed with other disks, the HP or HM driver must be used. 

ml ? refers to an entire MLll unit as a single sequentially 
addressed file. The size of each MLll unit depends on the 
number of array modules installed. There are 512 512-byte 
blocks per array module, for a maximum size of 8192 blocks 
per unit. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for more information about logical disk names and Appendix D 
for disk sizes. 

The MLll may be used for the swap device or perhaps mounted 
on /tmp. The MLll has switch-selectable transfer rates of 
0.25 mb, 0.5 mb, 1.0 mb, and 2.0 mb per second. The follow- 
ing transfer rate restrictions apply: 

0.25 mb all CPU's 

0.5 mb all CPU's 

1.0 mb PDP 11/70 with RH70 only 

2.0 mb NO PDPll CPU's 

The ml files access the disk via the system's normal buffer- 
ing mechanism and may be read and written without regard to 
physical disk records. A 'raw' interface provides for 
direct transmission between the disk and the user's read or 
write buffer. A single read or write call results in 
exactly one I/O operation and therefore raw I/O is consider- 
ably more efficient when many words are transmitted. The 
names of the raw files conventionally begin with an extra 
'r.' In raw I/O the buffer must begin on a word boundary. 



FILES 

/dev/ml#, /dev/rml# 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 
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RESTRICTIONS 

In raw I/O read and write (2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read , write and lseek(2) should always 
deal in 512-byte multiples. 
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NAME 

newtty - summary of the 'new' tty driver 

USAGE 

stty new 

stty new crt 

DESCRIPTION 

This is a summary of the new tty driver, described com- 
pletely, with the old terminal driver, in tty (4) . The new 
driver is largely compatible with the old but provides addi- 
tional functionality for job control. 

CRTs and printing terminals. 

The new terminal driver is normally set differently on CRTs 
and on printing terminals. On CRTs at speeds of 1200 baud 
or greater it normally erases input characters physically 
with backspace-space-backspace when they are erased logi- 
cally; at speed under 1200 baud this is often unreasonably 
slow, so the cursor is normally merely moved to the left. 
This is the behavior after a "stty new crt"; to have the tty 
driver always erase the characters use "stty new crt 
crterase crtkill"; to have the characters remain even at 
1200 baud or greater use "stty new crt -crterase -crtkill". 

On printing terminals the command "stty new prterase" should 
be given. Logically erased characters are then echoed 
printed backwards between a '\' and an '/' character. 

Other terminal modes are possible, but less commonly used; 
see tty (4) and stty (l) for details. 

Input editing and output control. 

When preparing input the character # (normally changed to -^H 
using stty (l) ) erases the last input character, '^W the last 
input word, and the character @ (often changed to ^U) erases 
the entire current input line. A •^R character causes the 
pending input to be retyped. Lines are terminated by a 
return or a newline; a ^D at the beginning of a line gen- 
erates an end-of-file. 

Control characters echo as -^x when typed, for some x; the 
delete character is represented as ^?. 

The character -^V may be typed before any character so that 
it may be entered without its special effect. For backwards 
compatibility with the old tty driver the character '\' 
prevents the special meaning of the character and line erase 
characters, much as -^V does. 
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Output is suspended when a ^S character is typed and res\amed 
when a -^Q character is typed. Output is discarded after a 
^0 character is typed until another -^0 is type, more input 
arrives, or the condition is cleared by a program (such as 
the shell just before it prints a prompt.) 

Signals. 

A non-interactive program is interrupted by a ^? (delete); 
this character is often reset to -^C using stty (l) . A quit 
^\ character causes programs to terminate like "^7 does, but 
also causes a core image file to be created which can then 
be examined with a debugger. This is often used to stop 
runaway processes. Interactive programs often catch inter- 
rupts and return to their command loop; only the most well 
debugged programs catch quits. 

Programs may be stopped by hitting ^Z, which returns control 
to the shell. They may then be resumed using the job con- 
trol mechanisms of the shell. The character -^Y is like ^Z 
but takes effect when read rather then when typed; it is 
much less frequently used. 

See tty (4) for a more complete description of the new termi- 
nal driver. 

SEE ALSO 

csh(l), stty(l), tty(4) 
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NAME 

null - data sink 

DESCRIPTION 

Data written on a null special file is discarded. 

Reads from a null special file always return bytes. 

FILES 

/dev/null 
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NAME 

tty - general terminal interface 

DESCRIPTION 

This section describes both a particular special file, and 
the general nature of the terminal interface. 

The file / dev / tty is, in each process, a synonym for the 
control terminal associated with that process. It is useful 
for programs that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can 
also be used for programs that demand a file name for out- 
put, when typed output is desired and it is tiresome to find 
out which terminal is currently in use. 

As for terminals in general: all of the low-speed asynchro- 
nous communications ports use the same general interface, no 
matter what hardware is involved. The remainder of this 
section discusses the common features of the interface. 

When a terminal file is opened, it causes the process to 
wait until a connection is established, unless the terminal 
line is set for local operation, see ttys (5). In practice 
user's programs seldom open these files; they are opened by 
init and become a user's input and output file. The very 
first terminal file open in a process becomes the control 
terminal for that process. The control terminal plays a 
special role in handling quit or interrupt signals, as dis- 
cussed below. The control terminal is inherited by a child 
process during a fork, even if the control terminal is 
closed. The set of processes that thus share a control ter- 
minal is called a process group ; all members of a process 
group receive certain signals together, see ^C below and 
kill (2). 

A terminal associated with one of these files ordinarily 
operates in full-duplex mode. Characters may be typed at 
any time, even while output is occurring, and are only lost 
when the system's character input buffers become completely 
choked, which is rare, or when the user has accumulated the 
maximum allowed number of input characters that have not yet 
been read by some program. Currently this limit is 256 
characters. When the input limit is reached all the saved 
characters are thrown away without notice. 

Normally, terminal input is processed in units of lines. 
This means that a program attempting to read will be 
suspended until an entire line has been typed. Also, no 
matter how many characters are requested in the read call, 
at most one line will be returned. It is not however neces- 
sary to read a whole line at once; any number of characters 
may be requested in a read, even one, without losing 
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information. There are special modes, discussed below, that 
permit the program to read each character as typed without 
waiting for a full line. 

During input, erase and kill processing is normally done. 
By default, the character 'DELETE' erases the last character 
typed, except that it will not erase beyond the beginning of 
a line or an EOT. By default, the character 'Control-U' 
kills the entire line up to the point where it was typed, 
but not beyond an EOT. Both these characters operate on a 
keystroke basis independently of any backspacing or tabbing 
that may have been done. Either 'Control-U' or 'DELETE' may 
be entered literally by preceding it by '\'; the erase or 
kill character remains, but the '\' disappears. These two 
characters may be changed to others. 

When desired, all upper-case letters are mapped into the 
corresponding lower-case letter. The upper-case letter may 
be generated by preceding it by '\'. In addition, the fol- 
lowing escape sequences can be generated on output and 
accepted on input: 



tor 


use 


" 


\' 


1 


\! 


'^ 


x-^ 


{ 


\( 


} 


\) 



Certain ASCII control characters have special meaning. 
These characters are not passed to a reading program except 
in raw mode where they lose their special character. Also, 
it is possible to change these characters from the default; 
see below. 

EOT (Control-D) may be used to generate an end of file from 
a terminal. When an EOT is received, all the charac- 
ters waiting to be read are immediately passed to the 
program, without waiting for a new-line, and the EOT is 
discarded. Thus if there are no characters waiting, 
which is to say the EOT occurred at the beginning of a 
line, zero characters will be passed back, and this is 
the standard end-of-file indication. 

^C (Control-C) is not passed to a program but generates an 
interrupt signal which is sent to all processes with 
the associated control terminal. Normally each such 
process is forced to terminate, but arrangements may be 
made either to ignore the signal or to receive a trap 
to an agreed-upon location. See signal (2) . 

FS (Control-\) generates the quit signal. Its treatment 
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is identical to the interrupt signal except that unless 
a receiving process has made other arrangements it will 
not only be terminated but a core image file will be 
generated. 

DC3 (Control-S) delays all printing on the terminal until 
something is typed in. 

DCl (Control-Q) restarts printing after DCS without gen- 
erating any input to a program. 

When the carrier signal from the dataset drops (usually 
because the user has hung up his terminal) a hangup signal 
is sent to all processes with the terminal as control termi- 
nal. Unless other arrangements have been made, this signal 
causes the processes to terminate. If the hangup signal is 
ignored, any read returns with an end-of-file indication. 
Thus programs that read a terminal and test for end-of-file 
on their input can terminate appropriately when hung up on. 

When one or more characters are written, they are actually 
transmitted to the terminal as soon as previously-written 
characters have finished typing. Input characters are 
echoed by putting them in the output queue as they arrive. 
When a process produces characters more rapidly than they 
can be typed, it will be suspended when its output queue 
exceeds some limit. When the queue has drained down to some 
threshold the program is resumed. Even parity is always 
generated on output. The EOT character is not transmitted 
(except in raw mode) to prevent terminals that respond to it 
from hanging up. 

Several ioctl(2) calls apply to terminals. Most of them use 
the following structure, defined in < sgtty .h>; 

struct sgttyb { 

char sg_ispeed; 

char sg_ospeed; 

char sg_erase; 

char sg_kill; 

int sg_flags; 
}; 

The sg ispeed and sg ospeed fields describe the input and 
output speeds of the device according to the following 
table, which corresponds to the DEC DH-11 interface. If 
other hardware is used, impossible speed changes are 
ignored. Symbolic values in the table are as defined in 
< sgtty .h>. 

BO (hang up dataphone) 
B50 1 50 baud 
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B75 


2 


75 baud 


BllO 


3 


110 baud 


B134 


4 


134.5 baud 


3150 


5 


150 baud 


B200 


6 


200 baud 


B300 


7 


300 baud 


B600 


8 


600 baud 


B1200 


9 


1200 baud 


B1800 


10 


1800 baud 


B2400 


11 


2400 baud 


B4800 


12 


4800 baud 


B9600 


13 


9600 baud 


EXTA 


14 


External A 


EXTB 


15 


External B 
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In the current configuration, only 110, 150, 300 and 1200 
baud are really supported on dial-up lines. Code conversion 
and line control required for IBM 2741 's (134.5 baud) must 
be implemented by the user's program. The half-duplex line 
discipline required for the 202 dataset (1200 baud) is not 
supplied; full-duplex 212 datasets work fine. 



The sg erase and sg kill fields of 
specify the erase and kill 



the argument structure 
characters respectively. 



specify 

(Defaults are DELETE and Control-U.) 

The sg flags field of the argument structure contains 
several bits that determine the system's treatment of the 
terminal: 

0177400 Delay algorithm selection 

0100000 Select backspace delays (not implemented): 



Select form-feed and vertical-tab delays: 



ALLDELAY 


0177400 


BSDELAY 


0100000 


BSO 





BSl 


0100000 


VTDELAY 


0040000 


FFO 





FFl 


0100000 


CRDELAY 


0030000 


CRO 





CRl 


0010000 


CR2 


0020000 


CR3 


0030000 


TBDELAY 


0006000 


TABO 





TABl 


0001000 


TAB 2 


0004000 


XTABS 


0006000 


NLDELAY 


0001400 


NLO 





NLl 


0000400 


NL2 


0001000 


NL3 


0001400 



Select carriage-return delays: 



Select tab delays: 



Select new-line delays: 
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EVENP 0000200 Even parity allowed on input (most terminals) 

ODDP 0000100 Odd parity allowed on input 

RAW 0000040 Raw mode: wake up on all characters, 

8-bit interface 

CRMOD 0000020 Map CR into LF; echo LF or CR as CR-LF 

ECHO 0000010 Echo (full duplex) 

LCASE 0000004 Map upper case to lower on input 

CBREAK 0000002 Return each character as soon as typed 

TANDEM 0000001 Automatic flow control 



The delay bits specify how long transmission stops to allow 
for mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of indicates 
no delay. 

Backspace delays are currently ignored but might be used for 
Terminet 300 's. 

If a form-feed/vertical tab delay is specified, it lasts for 
about 2 seconds. 

Carriage-return delay type 1 lasts about .08 seconds and is 
suitable for the Terminet 300. Delay type 2 lasts about .16 
seconds and is suitable for the VT05 and the TI 700. Delay 
type 3 is un implemented and is 0. 

New-line delay type 1 is dependent on the current column and 
IS tuned for Teletype model 37 's. Type 2 is useful for the 
VT05 and is about .10 seconds. Type 3 is unimplemented and 
IS 0. 

Tab delay type 1 is dependent on the amount of movement and 
IS tuned to the Teletype model 37. Type 3, called XTABS, is 
not a delay at all but causes tabs to be replaced by the 
appropriate number of spaces on output. 

Characters with the wrong parity, as determined by bits 200 
and 100, are ignored. 

In raw mode, every character is passed immediately to the 
program without waiting until a full line has been typed. 
No erase or kill processing is done; the end-of-file indica- 
tor (EOT), the interrupt character (Control-C) and the quit 
character (FS) are not treated specially. There are no 
delays and no echoing, and no replacement of one character 
for another; characters are a full 8 bits for both input and 
output (parity is up to the program). 

Mode 020 causes input carriage returns to be turned into 
new-lines; input of either CR or LF causes LF-CR both to be 
echoed (for terminals with a new-line function). 
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CBREAK is a sort of half -cooked (rare?) mode. Programs can 
read each character as soon as typed, instead of waiting for 
a full line, but quit and interrupt work, and output delays, 
case-translation, CRMOD, XTABS, ECHO, and parity work nor- 
mally. On the other hand there is no erase or kill, and no 
special treatment of \ or EOT. 

TANDEM mode causes the system to produce a stop character 
(default DC3) whenever the input queue is in danger of over- 
flowing, and a start character (default DCl) when the input 
queue has drained sufficiently. It is useful for flow con- 
trol when the 'terminal' is actually another machine that 
obeys the conventions. 

Several ioctl calls have the form: 

finclude <sgtty.h> 

ioctKf ildes, code, arg) 
struct sgttyb *arg; 

The applicable codes are: 

TIOCGETP 

Fetch the parameters associated with the terminal, and 
store in the pointed-to structure. 

TIOCSETP 

Set the parameters according to the pointed-to struc- 
ture. The interface delays until output is quiescent, 
then throws away any unread characters, before changing 
the modes. 

TIOCGETD 

Fetch the line discipline number associated with the 
terminal, and store in the first character of the 
pointed-to structure. 

TIOCSETD 

Set the line discipline number according to the the 
first character of the pointer-to structure. 

TIOCSETN 

Set the parameters but do not delay or flush input. 
Switching out of RAW or CBREAK mode may cause some gar- 
bage input. 

TIOCETQ 

Set the flags field of the pointed-to structure equal 
to the number of characters waiting on the RAW Q or the 
CANONICAL Q, which ever is greater. 
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With the following codes the arq is ignored. 

TIOCEXCL 

Set "exclusive-use" mode: no further opens are permit- 
ted until the file has been closed. 

TIOCNXCL 

Turn off "exclusive-use" mode. 

TIOCHPCL 

When the file is closed for the last time, hang up the 
terminal. This is useful when the line is associated 
with an ACU used to place outgoing calls. 

TIOCFLUSH 

All characters waiting in input or output queues are 
flushed. 

TIOCSDTR 

Causes the Data Terminal Ready (DTK) signal to be 
asserted on the communications port associated with 
f ildes . 

TIOCCDTR 

Removes the DTR signal from the communications port. 

TIOCSBRK 

Sets a break condition on the communications port asso- 
ciated with f ildes . 

TIOCCBRK 

Removes the break condition from the communications 
port. 

The following codes affect characters that are special to 
the terminal interface. The argument is a pointer to the 
following structure, defined in < sgtty .h>; 

struct tchars { 

char t_intrc; /* interrupt */ 

char t_quitc; /* quit */ 

char t_startc; /* start output */ 

char t_stopc; /* stop output */ 

char t_eofc; /* end-of-file */ 

char t_brkc; /* input delimiter (like nl) */ 
}; 

The default values for these characters are Control-C, FS, 
DCl, DC3, EOT, and -1. A character value of -1 eliminates 
the effect of that character. The t brkc character, by 
default -1, acts like a new-line in that it terminates a 
line, IS echoed, and is passed to the program. The 'stop' 
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and 'start' characters may be the same, to produce a toggle 
effect. It is probably counterproductive to make other spe- 
cial characters (including erase an kill) identical. 

The calls are: 

TIOCSETC 

Change the various special characters to those given in 
the structure. 

TIOCGETC 

Fetch the special characters and store in the pointed 
to structure. 

The following codes affect erase/kill processing modes for 
the terminal. 

These ioctl's accept and return integer values only. 

The calls are: 

TIOCSETT 

Set the erase/kill processing flags to the value in the 
pointed to integer. 

TIOCGETT 

Fetch the erase/kill flags and store in the pointed to 
integer. 

The valid values for erase/kill processing flag are: 

LCRTBS 000001 Backspace on erase, don't echo erase character. 

LCRTERA 000002 Use backspace-space-backspace to rubout character, 

LPRTERA 000004 Printing terminal erase mode. 

LCRTKIL 000010 Use LCRTERA method to kill the line. 

LCTLECH 000020 Echo input control chars as -^X, delete as -^7. 

LCRTSLO 000040 Low speed (< 1200 baud). Use newline for kill. 

FILES 

/dev/tty 

/dev/tty## 

/dev/console 

SEE ALSO 

getty(8), stty (1), signal(2), ioctl(2), newtty(4), init(8) 
ULTRIX-11 System Management Guide, Sections 1.4.5 and 2.6.3 
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RESTRICTIONS 

Half-duplex terminals are not supported. 

The terminal handler has clearly entered the race for ever- 
greater complexity and generality. It's still not complex 
and general enough for TENEX fans. 
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NAME 

pk - packet driver 

DESCRIPTION 

The packet driver implements a full-duplex end-to-end flow 
control strategy for machine-to-machine communication. 
Packet driver protocol is established by calling pkon (2) 
with a character device file descriptor and a desired packet 
size in bytes. The packet size must be a power of 2, 
32<=size<=4096. The file descriptor must represent an 8-bit 
data path. This is normally obtained by setting the device 
in raw mode (see ioctl (2) ) . 

The actual packet size, which may be smaller than the 
desired packet size, is arrived at by negotiation with the 
packet driver at the remote end of the data link. 

The packet driver maintains two data areas for incoming and 
outgoing packets. The output area is needed to implement 
retransmission on errors, and arriving packets are queued in 
the input area. Data arriving for a file not open for read- 
ing is discarded. Initially the size of both areas is set 
to two packets. 

It is not necessary that reads and writes be multiples of 
the packet size although there is less system overhead if 
they are. Read operations return the maximum amount of data 
available from the input area up to the number of bytes 
specified in the system call. The buffer sizes in write 
operations are not normally transmitted across the link. 
However, writes of zero length are treated specially and are 
reflected at the remote end as a zero-length read. This 
facilitates marking the serial byte stream, usually for del- 
imiting files. 

When one side of a packet driver link is shut down by 
close(2)or pkoff (see pkon (2) ) , read (2) on the other side 
will return 0, and write on the other side will raise a SIG- 
PIPE signal. 

RESTRICTIONS 

The pkon(2) system call does not exist. The packet driver 
is not supported by ULTRIX-11. 

SEE ALSO 

pkon(2), pkopenO) 

ULTRIX-11 Software Technical Description 
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NAME 



ra - UDA50/RA60, RA80, RA81 Winchester disks 

rd/rx - RQDX1/RD51/RD52 Winchester disk and RX50 floppy disk 

re - KLESI/RC25 Winchester disk 



DESCRIPTION 

The RA disk driver supports the UDA50 disk controller , used 
with unibus PDPll processors, and the RQDXl Q bus disk con- 
troller. Both of these controllers support the Digital 
Storage Architecture (DSA) disks via the Mass Storage Con- 
trol Protocol (MSCP). 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for information about logical disk names and Appendix D for 
disk partition sizes. 

The ra files access the disk via the system's normal buffer- 
ing mechanism and may be read and written without regard to 
physical disk records. 

A 'raw' interface provides for direct transmission between 
the disk and the user's read or write buffer. A single read 

I/O operation and 



or write call results in exactly one 
therefore raw I/O is considerably more 
words are transmitted. The names of the 



tionally begin with an extra 
begin on a word boundary. 



efficient when many 
raw files conven- 
In raw I/O the buffer must 



FILES 

/dev/ra##, /dev/rra## 
/dev/rd#, /dev/rrd# 
/dev/rx#, /dev/rrx# 
/dev/rc#, /dev/rrc# 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O read and write(2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read , write and lseek(2) should always 
deal in 512-byte multiples. 
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NAME 

rk - RK11/RK03 or RK05 disk 

DESCRIPTION 

Rk# refers to an entire disk as a single sequentially- 
addressed file. Its 256-word blocks are numbered to 4871. 
Minor device numbers are drive numbers on one controller. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for more information about logical disk names and Appendix D 
for disk sizes. 

The rk files discussed above access the disk via the 
system's normal buffering mechanism and may be read and 
written without regard to physical disk records. There is 
also a 'raw' interface which provides for direct transmis- 
sion between the disk and the user's read or write buffer. 
A single read or write call results in exactly one I/O 
operation and therefore raw I/O is considerably more effi- 
cient when many words are transmitted. The names of the raw 
RK files begin with rrk and end with a number which selects 
the same disk as the corresponding rk file. 

In raw I/O the buffer must begin on a word boundary, and 
counts should be a multiple of 512 bytes (a disk block). 
Likewise seek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rk#, /dev/rrk# 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O read and write (2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read , write and lseek (2) should always 
deal in 512-byte multiples. 
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NAME 

rl - RLll/RLOl or RL02 disk 

DESCRIPTION 

The RLll controller supports a mix of up to four RL01/RL02 
disks. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for more information about logical disk names and Appendix D 
for disk sizes. 

Rl# refers to an entire disk as a single sequentially- 
addressed file. Its 256-word blocks are numbered to 10239 
(RLOl) or to 20479 (RL02). The physical disk sector size 
is 128 words, however the logical block size is 256 words. 
Minor device numbers are drive nvimbers on one controller. 

The rl files discussed above access the disk via the 
system's normal buffering mechanism and may be read and 
written without regard to physical disk records. 

There is also a 'raw' interface which provides for direct 
transmission between the disk and the user's read or write 
buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the 
raw RL files begin with rrl and end with a number which 
selects the same disk as the corresponding rl file. 

In raw I/O the buffer must begin on a word boundary, and 
counts should be a multiple of 512 bytes (a disk block). 
Likewise seek calls should specify a multiple of 512 bytes. 

FILES 

/dev/rl#, /dev/rrl# 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O read and write (2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read, write and lseek (2) should always 
deal in 512-byte multiples. 
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NAME 

rp - RP11/RP02 or RP03 moving-head disk 

DESCRIPTION 

The RPll controller supports a mix of up to eight RP02/RP03 
disk drives. 

The files rpO ... rp7 refer to sections of RP disk drive 0. 
The files rp8 ... rpl5 refer to drive 1 etc. This allows a 
large disk to be broken up into more manageable pieces. 

Refer to the ULTRIX-11 System Management Guide, Section 1.4 
for more information about logical disk names and Appendix D 
for disk partition sizes. 

The rp files access the disk via the system's normal buffer- 
ing mechanism and may be read and written without regard to 
physical disk records. 

There is also a 'raw' interface which provides for direct 
transmission between the disk and the user's read or write 
buffer. A single read or write call results in exactly one 
I/O operation and therefore raw I/O is considerably more 
efficient when many words are transmitted. The names of the 
raw RP files begin with rrp and end with a number which 
selects the same disk section as the corresponding rp file. 

In raw I/O the buffer must begin on a word boundary. 

FILES 

/dev/rp##, /dev/rrp## 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O read and write(2) truncate file offsets to 512- 
byte block boundaries, and write scribbles on the tail of 
incomplete blocks. Thus, in programs that are likely to 
access raw devices, read, write and lseek (2) should always 
deal in 512-byte multiples. 
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NAME 

tc - TC11/TU56 DECtape 

DESCRIPTION 

The files tapO ... tap7 refer to the TC-11/TU56 DECtape 
drives to 7. 

The 256-word blocks on a standard DECtape are numbered to 
577. 

The unibus interrupt request priority level for the TCll 
must be set to BR 6. 

FILES 

/dev/tap? 

SEE ALSO 

tp(l) 

RESTRICTIONS 

DECtape is an obsolete device and is not supported by 
ULTRIX-11. 
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NAME 

tm - TMll - TU10/TE10/TS03 800 BPI magtape interface 

DESCRIPTION 

The files mtO, ..., mt7 refer to the DEC TMll magtape. When 
closed it can be rewound or not, see below. If it was open 
for writing, two end-of-files are written. If the tape is 
not to be rewound it is positioned with the head between the 
two tapemarks. If the 0200 bit is on in the minor device 
number the tape is not rewound when closed. Refer to the 
ULTRIX-11 System Management Guide, Section 1.4 for more 
information about magtape logical device names. 

A standard tape consists of a series of 512 byte records 
terminated by an end-of-file. To the extent possible, the 
system makes it possible, if inefficient, to treat the tape 
like any other file. Seeks have their usual meaning and it 
is possible to read or write a byte at a time. Writing in 
very small units is inadvisable, however, because it tends 
to create monstrous record gaps. 

The mt files discussed above are useful when it is desired 
to access the tape in a way compatible with ordinary files. 
When foreign tapes are to be dealt with, and especially when 
long records are to be read or written, the 'raw' interface 
is appropriate. The associated files are named rmtO , ..., 
rmt7 . Each read or write call reads or writes the next 
record on the tape. In the write case the record has the 
same length as the buffer given. During a read, the record 
size is passed back as the number of bytes read, provided it 
is no greater than the buffer size; if the record is long, 
an error is indicated. In raw tape I/O, the buffer must 
begin on a word boundary and the count must be even. Seeks 
are ignored. A zero byte count is returned when a tape mark 
is read, but another read will fetch the first record of the 
new tape file. 

FILES 

/dev/mt#, /dev/rmt#, /dev/nrmt# 

SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and Appendix 

A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

If any non-data error is encountered, it refuses to do any- 
thing more until closed. In raw I/O, there should be a way 
to perform forward and backward record and file spacing and 
to write an EOF mark. 
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NAME 

ts - TS11/TSV05/TU80/TK25 1600 BPI magtape interface 

DESCRIPTION 

The TS driver supports a single TSll for unibus processors 
and a single TSV05 for Q bus processors. 

The file ht# refers to the DEC TSll magtape. When opened 
for reading or writing, the tape is not rewound. When 
closed, it is rewound (unless the 0200 bit is on, see 
below). If the tape was open for writing, a double end-of- 
file is written. If the tape is not to be rewound the tape 
is backspaced to just between the two tapemarks. 

A standard tape consists of a series of 512 byte records 
terminated by a double end-of-file. To the extent possible, 
the system makes it possible, if inefficient, to treat the 
tape like any other file. Seeks have their usual meaning 
and it is possible to read or write a byte at a time. Writ- 
ing in very small units is inadvisable, however, because it 
tends to create monstrous record gaps. 

If the 0200 bit is on {initial digit 2 or 3), the tape is 
not rewound on close. Note that the minor device number has 
no necessary connection with the file name. 

The ht files discussed above are useful when it is desired 

to access the tape in a way compatible with ordinary files. 

When foreign tapes are to be dealt with, and especially when 

long records are to be read or written, the 'raw' interface 
is appropriate. The associated file may be named rht # but 

the same minor-device considerations as for the regular 
files still apply. 

Each read or write call reads or writes the next record on 
the tape. In the write case the record has the same length 
as the buffer given. During a read, the record size is 
passed back as the number of bytes read, provided it is no 
greater than the buffer size; if the record is long, an 
error is indicated. In raw tape I/O, the buffer must begin 
on a word boundary and the count must be even. Seeks are 
ignored. A zero count is returned when a tape mark is read; 
another read will fetch the first record of the next tape 
file. 

FILES 

/dev/ht#, /dev/rht#, /dev/nrht# 
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SEE ALSO 

ULTRIX-11 System Management Guide, Section 2.6 and 

Appendix A 

ULTRIX-11 Software Technical Description 

RESTRICTIONS 

In raw I/O, there should be a way to perform forward and 
backward record and file spacing and to write an EOF mark 
explicitly. 
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NAME 

tty - general terminal interface 

DESCRIPTION 

This section describes both a particular special file 
/dev/tty and the terminal drivers used for conversational 
computing. 

Line disciplines. 

The system provides different line disciplines for control- 
ling communications lines. In this version of the system 
there are two disciplines available: 

old The old (standard) terminal driver. This is used 
when using the standard shell sh{l) and for compati- 
bility with other standard version 7 UNIX systems. 

new A newer terminal driver, with features for job con- 
trol; this must be used when using csh (l) . See 
newtty (l) for a short user-level summary. 

Line discipline switching is accomplished with the TIOCSETD 
ioctl ; 

int Idisc = LDISC; ioctK f iledes, TIOCSETD, Sddisc); 

where LDISC is OTTYDISC for the standard tty driver and 
NTTYDISC for the new driver. The standard (currently old) 
tty driver is discipline by convention. The current line 
discipline can be obtained with the TIOCGETD ioctl. Pending 
input is discarded when the line discipline is changed. 

All of the low-speed asynchronous communications ports can 
use any of the available line disciplines, no matter what 
hardware is involved. 

The control terminal. 

When a terminal file is opened, it causes the process to 
wait until a connection is established. In practice, user 
programs seldom open these files; they are opened by init (8) 
and become a user's standard input and output file. 

If a process which has no control terminal opens a terminal 
file, then that terminal file becomes the control terminal 
for that process. The control terminal is thereafter inher- 
ited by a child process during a fork(2), even if the con- 
trol terminal is closed. 

The file /dev/tty is, in each process, a synonym for a con- 
trol terminal associated with that process. It is useful 
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for programs that wish to be sure of writing messages on the 
terminal no matter how output has been redirected. It can 
also be used for programs that demand a file name for out- 
put, when typed output is desired and it is tiresome to find 
out which terminal is currently in use. 

Process groups. 

As described more completely in jobs (3) , command processors 
such as csh(l) can arbitrate the terminal between different 
jobs by placing related jobs in a single process group and 
associating this process group with the terminal. A 
terminal's associated process group may be set using the 
TIOCSPGRP ioctl(2): 

ioctKf ildes, TIOCSPGRP, &pgrp) 

or examined using TIOCGPGRP rather than TIOCSPGRP, returning 
the current process group in pgrp . The new terminal driver 
aids in this arbitration by restricting access to the termi- 
nal by processes which are not in the current process group; 
see Job access control below. 

Modes . 

The terminal drivers have three major modes, characterized 
by the amount of processing on the input and output charac- 
ters: 



cooked 



CBREAK 



The normal mode. In this mode lines of input are 
collected and input editing is done. The edited 
line is made available when it is completed by a 
newline or when an EOT (control-D, hereafter -^D) 
is entered. A carriage return is usually made 
synonymous with newline in this mode, and replaced 
with a newline whenever it is typed. All driver 
functions (input editing, interrupt generation, 
output processing such as delay generation and tab 
expansion, etc.) are available in this mode. 

This mode eliminates the character, word, and line 



editing input 
ter available 
Flow control 
ing are still 
ing is done. 



facilities, making the input charac- 
to the user program as it is typed. 
, literal-next and interrupt process- 
done in this mode. Output process- 



RAW 



This mode eliminates all input processing and 
makes all input characters available as they are 
typed; no output processing is done either. TAN- 
DEM mode is available for input flow control, how- 
ever; see below. Characters are a full 8 bits 
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(parity is up to the program). 

The style of input processing can also be very different 
when, in the new terminal driver, a process asks for notifi- 
cation via a SIGTTIN signal (2) when input is ready to be 
read from the control terminal. In this case a read(2) from 
the control terminal will never block, but ratheFTeturn an 
error indication (EIO) if there is no input available. 

Input editing. 

A UNIX terminal ordinarily operates in full-duplex mode. 
Characters may be typed at any time, even while output is 
occurring, and are only lost when the system's character 
input buffers become completely choked, which is rare, or 
when the user has accumulated the maximum allowed number' of 
input characters that have not yet been read by some pro- 
gram. Currently this limit is 256 characters. In the old 
terminal driver all the saved characters are thrown away 
when the limit is reached, without notice; the new driver 
simply refuses to accept any further input, and rings the 
terminal bell. 

Input characters are normally accepted in either even or odd 
parity with the parity bit being stripped off before the 
character is given to the program. By clearing either the 
EVEN or ODD bit in the flags word it is possible to have 
input characters with that parity discarded (see the Summary 
below. ) ^ 

In all of the line disciplines, it is possible to simulate 
terminal input using the TIOCSTI ioctl , which takes, as its 
third argument, the address of a character. The system pre- 
tends that this character was typed on the argument termi- 
nal, which must be the control terminal except when executed 
by the superuser (this call is not in standard version 7 
UNIX). 

Input characters are normally echoed by putting them in an 
output queue as they arrive. This may be disabled by clear- 
ing the ECHO bit in the flags word using the stty(2) call or 
the TIOCSETN or TIOCSETP ioctl s (see the Summii^below) . 

In cooked mode, terminal input is processed in units of 
lines. A program attempting to read will normally be 
suspended until an entire line has been received (but see 
the description of SIGTTIN in Modes above and FIONREAD in 
Summary below. ) No matter how many characters are requested 
in the read call, at most one line will be returned. It is 
not, however, necessary to read a whole line at once; any 
number of characters may be requested in a read, even one 
without losing information. ' 
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During input, line editing is normally done, with the char- 
acter '#' logically erasing the last character typed and the 
character '(§' logically erasing the entire current input 
line. These are often reset on crt's, with '^H replacing #, 
and ^U replacing @. These characters never erase beyond the 
beginning of the current input line or an '^D. These charac- 
ters may be entered literally by preceding them with '\'; in 
the old teletype driver both the '\' and the character 
entered literally will appear on the screen; in the new 
driver the '\' will normally disappear. 

The drivers normally treat either a carriage return or a 
newline character as terminating an input line, replacing 
the return with a newline and echoing a return and a line 
feed. If the CRMOD bit is cleared in the local mode word 
then the processing for carriage return is disabled, and it 
is simply echoed as a return, and does not terminate cooked 
mode input. 

In the new driver there is a literal-next character -^V which 
can be typed in both cooked and CBREAK mode preceding any 
character to prevent its special meaning. This is to be 
preferred to the use of '\' escaping erase and kill charac- 
ters, but '\' is (at least temporarily) retained with its 
old function in the new driver for historical reasons. 

The new terminal driver also provides two other editing 
characters in normal mode. The word-erase character, nor- 
mally "^W, erases the preceding word, but not any spaces 
before it. For the purposes of -^W, a word is defined as a 
sequence of non-blank characters, with tabs counted as 
blanks. Finally, the reprint character, normally ^R, 
retypes the pending input beginning on a new line. Retyping 
occurs automatically in cooked mode if characters which 
would normally be erased from the screen are fouled by pro- 
gram output. 

Input echoing and redisplay 

In the old terminal driver, nothing special occurs when an 
erase character is typed; the erase character is simply 
echoed. When a kill character is typed it is echoed fol- 
lowed by a new-line (even if the character is not killing 
the line, because it was preceded by a '\'!). 

The new terminal driver has several modes for handling the 
echoing of terminal input, controlled by bits in a local 
mode word. 

Hardcopy te rminals . When a hardcopy terminal is in use, the 
LPRTERA bit IS normally set in the local mode word. Charac- 
ters which are logically erased are then printed out 
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backwards preceded by 'X' and followed by '/' in this mode. 

Crt terminals . When a crt terminal is in use, the LCRTBS bit 
IS normally set in the local mode word. The terminal driver 
then echoes the proper number of erase characters when input 
is erased; in the normal case where the erase character is a 
'^H this causes the cursor of the terminal to back up to 
where it was before the logically erased character was 
typed. If the input has become fouled due to interspersed 
asynchronous output, the input is automatically retyped. 

Erasing characters from a crt. When a crt terminal is in 
use, the LCRTERA bit may be set to cause input to be erased 
from the screen with a "backspace-space-backspace" sequence 
when character or word deleting sequences are used. A 
LCRTKIL bit may be set as well, causing the input to' be 
erased in this manner on line kill sequences as well. 

Echoing of control characters. If the LCTLECH bit is set in 
the local state word, then non-printing (control) characters 
are normally echoed as ^X (for some X) rather than being 
echoed unmodified; delete is echoed as ^? . 

The normal modes for using the new terminal driver on crt 
terminals are speed dependent. At speeds less than 1200 
baud, the LCRTERA and LCRTKILL processing is painfully slow 
so stty(l) normally just sets LCRTBS and LCTLECH; at speeds 
of 1200 baud or greater all of these bits are normally set. 
Stty (l) summarizes these option settings and the use of the 
new terminal driver as "newcrt." 

Output processing. 

When one or more characters are written, they are actually 
transmitted to the terminal as soon as previously-written 
characters have finished typing. (As noted above, input 
characters are normally echoed by putting them in the output 
queue as they arrive.) When a process produces characters 
more rapidly than they can be typed, it will be suspended 
when Its output queue exceeds some limit. When the queue 
has drained down to some threshold the program is resumed. 
Even parity is normally generated on output. The EOT char- 
acter is not transmitted in cooked mode to prevent terminals 
that respond to it from hanging up; programs using raw or 
cbreak mode should be careful. 

The terminal drivers provide necessary processing for cooked 
and CBREAK mode output including delay generation for cer- 
tain special characters and parity generation. Delays are 
available after backspaces ^H, form feeds '"L, carriage 
returns ^M, tabs '^I and newlines '^J. The driver will also 
optionally expand tabs into spaces, where the tab stops are 
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assumed to be set every eight columns. These functions are 
controlled by bits in the tty flags word; see Summary below. 

The terminal drivers provide for mapping between upper and 
lower case on terminals lacking lower case, and for other 
special processing on deficient terminals. 

Finally, in the new terminal driver, there is a output flush 
character, normally ^0, which sets the LFLUSHO bit in the 
local mode word, causing subsequent output to be flushed 
until it is cleared by a program or more input is typed. 
This character has effect in both cooked and CBREAK modes 
and causes pending input to be retyped if there is any pend- 
ing input. loctls to flush the characters in the input and 
output queues, TIOCFLUSH, and to return the number of char- 
acters still in the output queue, TIOCOUTQ are also avail- 
able. 

Upper case terminals and Hazeltines 

If the LCASE bit is set in the tty flags, then all upper- 
case letters are mapped into the corresponding lower-case 
letter. The upper-case letter may be generated by preceding 
it by '\'. In addition, the following escape sequences can 
be generated on output and accepted on input: 

for ^ I ~ { } 
use \' \! \- \( \) 

To deal with Hazeltine terminals, which do not understand 
that ~ has been made into an ASCII character, the LTILDE bit 
may be set in the local mode word when using the new termi- 
nal driver; in this case the character ~ will be replaced 
with the character ' on output. 

Flow control. 

There are two characters (the stop character, normally '"^S, 
and the start character, normally '^Q) which cause output to 
be suspended and resumed respectively. Extra stop charac- 
ters typed when output is already stopped have no effect, 
unless the start and stop characters are made the same, in 
which case output resumes. 

A bit in the flags word may be set to put the terminal into 
TANDEM mode. In this mode the system produces a stop char- 
acter (default ^S) when the input queue is in danger of 
overflowing, and a start character (default "^Q) when the 
input has drained sufficiently. This mode is useful when 
the terminal is actually another machine that obeys the con- 
ventions. 
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Line control and breaks. 

There are several ioctl calls available to control the state 
of the terminal line. The TIOCSBRK ioctl will set the break 
bit in the hardware interface causing a break condition to 
exist; this can be cleared (usually after a delay with 
sleep O)) by TIOCCBRK. Break conditions in the input are 
reflected as a null character in RAW mode or as the inter- 
rupt character in cooked or CBREAK mode. The TIOCCDTR ioctl 
will clear the data terminal ready condition; it can be set 
again by TIOCSDTR. TIOCSBRK, TIOCBRK, TIOCSDTR and TIOCCDTR 
are available only where the hardware and device driver are 
able to support them. 

When the carrier signal from the dataset drops (usually 
because the user has hung up his terminal) a SIGHUP hangup 
signal is sent to the processes in the distinguished process 
group of the terminal; this usually causes them to terminate 
(the SIGHUP can be suppressed by setting the LNOHANG bit in 
the local state word of the driver.) Access to the terminal 
by other processes is then normally revoked, so any further 
reads will fail, and programs that read a terminal and test 
for end-of-file on their input will terminate appropriately. 

It is possible to ask that the phone line be hung up on the 
last close with the TIOCHPCL ioctl ; this is normally done on 
the outgoing line. 

Interrupt characters. 

There are several characters that generate interrupts in 
cooked and CBREAK mode; all are sent the processes in the 
control group of the terminal, as if a TIOCGPGRP ioctl were 
done to get the process group and then a killpq (2) system 
call were done, except that these characters also flush 
pending input and output when typed at a terminal (a 'la 
TIOCFLUSH) . The characters shown here are the defaults; the 
field names in the structures (given below) are also shown. 
The characters may be changed, although this is not often 
done. 

^1 t_intrc (Delete) generates a SIGINTR signal. This is 
the normal way to stop a process which is no longer 
interesting, or to regain control in an interactive 
program. 

-^X t_quitc (FS) generates a SIGQUIT signal. This is used 

to cause a program to terminate and produce a core 

image, if possible, in the file core in the current 
directory. 

^Z t_suspc (EM) generates a SIGTSTP signal, which is used 
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to suspend the current process group. 

-^Y t_dstopc (SUB) generates a SIGTSTP signal as ^Z does, 
but the signal is sent when a program attempts to read 
the '^Y, rather than when it is typed. 

Job access control. 

When using the new terminal driver, if a process which is 
not in the distinguished process group of its control termi- 
nal attempts to read from that terminal its process group is 
sent a SIGTTIN signal, which normally causes the members of 
that process group to stop. If, however, the process is 
ignoring or holding SIGTTIN signal, is an orphan its parent 
has exited and it has been inherited by the init (8) process, 
or if it is a process in the middle of process creation 
using vfork (2) ) , it is instead returned an end-of-file. 
Under older UNIX systems these processes would typically 
have had their input files reset to /dev/null, so this is a 
compatible change. 

When using the new terminal driver with the LTOSTOP bit set 
in the local modes, a process is prohibited from writing on 
its control terminal if it is not in the distinguished pro- 
cess group for that terminal. Processes which are holding 
or ignoring SIGTTOU signals, which are orphans, or which are 
in the middle of a vfork (2) are excepted and allowed to pro- 
duce output. 

Summary of modes. 

Unfortunately, due to the evolution of the terminal driver, 
there are 4 different structures which contain various por- 
tions of the driver data. The first of these (sgttyb) con- 
tains that part of the information largely common between 
version 6 and version 7 UNIX systems. The second contains 
additional control characters added in version 7. The third 
is a word of local state peculiar to the new terminal 
driver, and the fourth is another structure of special char- 
acters added for the new driver. In the future a single 
structure may be made available to programs which need to 
access all this information; most programs need not concern 
themselves with all this state. 

The basic ioctl s use the structure defined in < sgtty .h>; 

struct sgttyb { 

char sg_ispeed; 
char sg_ospeed; 
char sg_erase; 
char sg_kill; 
shortsg_f lags; 

}; 
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}; 



The sg i speed and sq ospeed fields describe the input and 
output speeds of the device according to the following 
table, which corresponds to the DEC DH-11 interface. If 
other hardware is used, impossible speed changes are 
ignored. Symbolic values in the table are as defined in 
< sgtty .h>. 



BO 





(hang up dataphone) 


B50 


1 


50 baud 


B75 


2 


75 baud 


BllO 


3 


110 baud 


B134 


4 


134.5 baud 


B150 


5 


150 baud 


B200 


6 


200 baud 


B300 


7 


300 baud 


B600 


8 


600 baud 


B1200 


9 


1200 baud 


B1800 


10 


1800 baud 


B2400 


11 


2400 baud 


B4800 


12 


4800 baud 


B9600 


13 


9600 baud 


EXTA 


14 


External A 


EXTB 


15 


External B 



In the current configuration, only 110, 150, 300 and 1200 
baud are really supported on dial-up lines. Code conversion 
and line control required for IBM 2741's (134.5 baud) must 
be implemented by the user's program. The half -duplex line 
discipline required for the 202 dataset (1200 baud) is not 
supplied; full-duplex 212 datasets work fine. 

The sg erase and sg kill fields of the argument structure 
specify the erase and kill characters respectively. 
(Defaults are # and @.) 



The sg flags 
several bits 
terminal : 



field of the argument structure contains 
that determine the system's treatment of the 



ALLDELAY 0177400 
BSDELAY 0100000 



BSO 





BSl 


0100000 


VTDELAY 


0040000 


FFO 





FFl 


0100000 


CRDELAY 


0030000 


CRO 





CRl 


0010000 


CR2 


0020000 



Delay algorithm selection 

Select backspace delays (not implemented): 



Select form-feed and vertical-tab delays: 



Select carriage-return delays; 
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CR3 


0030000 


TBDELAY 


0006000 


TABO 





TABl 


0001000 


TAB 2 


0004000 


XTABS 


0006000 


NLDELAY 


0001400 


NLO 





NLl 


0000400 


NL2 


0001000 


NL3 


0001400 


EVENP 


0000200 


ODDP 


0000100 


RAW 


0000040 


CRMOD 


0000020 


ECHO 


0000010 


LCASE 


0000004 


CBREAK 


0000002 


TANDEM 


0000001 



Select tab delays: 



Select new-line delays: 



Even parity allowed on input 

(most terminals) 
Odd parity allowed on input 
Raw mode: wake up on all characters, 

8-bit interface 
Map CR into LF; echo LF or CR as CR-LF 
Echo {full duplex) 
Map upper case to lower on input 
Return each character as soon as typed 
Automatic flow control 



The delay bits specify how long transmission stops to allow 
for mechanical or other movement when certain characters are 
sent to the terminal. In all cases a value of indicates 
no delay. 

Backspace delays are currently ignored but might be used for 
Terminet 300's. 

If a form-feed/vertical tab delay is specified, it lasts for 
about 2 seconds. 

Carriage-return delay type 1 lasts about .08 seconds and is 
suitable for the Terminet 300. Delay type 2 lasts about .16 
seconds and is suitable for the VT05 and the TI 700. Delay 
type 3 is suitable for the concept-100 and pads lines to be 
at least 9 characters at 9600 baud. 

New-line delay type 1 is dependent on the current column and 

is tuned for Teletype model 37 's. Type 2 is useful for the 

VT05 and is about .10 seconds. Type 3 is unimplemented and 
is 0. 

Tab delay type 1 is dependent on the amount of movement and 
is tuned to the Teletype model 37. Type 3, called XTABS, is 
not a delay at all but causes tabs to be replaced by the 
appropriate number of spaces on output. 

Input characters with the wrong parity, as determined by 
bits 0200 and 0100, are ignored in cooked and CBREAK mode. 
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RAW disables all processing save output flushing with 
LFLUSHO; full 8 bits of input are given as soon as it is 
available; all 8 bits are passed on output. A break condi- 
tion in the input is reported as a null character. If the 
input queue overflows in raw mode it is discarded; this 
applies to both new and old drivers. 

CRMOD causes input carriage returns to be turned into new- 
lines; input of either CR or LF causes LF-CR both to be 
echoed (for terminals with a new-line function). 

CBREAK is a sort of half -cooked (rare?) mode. Programs can 
read each character as soon as typed, instead of waiting for 
a full line; all processing is done except the input edit- 
ing: character and word erase and line kill, input reprint, 
and the special treatment of \ or EOT are disabled. 

TANDEM mode causes the system to produce a stop character 
(default ^S) whenever the input queue is in danger of over- 
flowing, and a start character (default '^Q) when the input 
queue has drained sufficiently. It is useful for flow con- 
trol when the 'terminal' is really another computer which 
understands the conventions. 

In addition to the TIOCSETD and TIOCGETD disciplines dis- 
cussed in Line disciplines above, a large number of other 
ioctl(2) calls apply to terminals, and have the general 
form: 

finclude <sgtty.h> 

ioctKf ildes, code, arg) 
struct sgttyb *arg; 

The applicable codes are: 

TIOCGETP Fetch the basic parameters associated with 
the terminal, and store in the pointed-to 
sgttyb structure. 

TIOCSETP Set the parameters according to the pointed- 
to sgttyb structure. The interface delays 
until output is quiescent, then throws away 
any unread characters, before changing the 
modes. 

TIOCSETN Set the parameters like TIOCSETP but do not 

delay or flush input. Input is not 

preserved, however, when changing to or from 
RAW. 
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With the following codes the arg is ignored. 

TIOCEXCL Set "exclusive-use" mode: no further opens 

are permitted until the file has been closed. 

TIOCNXCL Turn off "exclusive-use" mode. 

TIOCHPCL When the file is closed for the last time, 
hang up the terminal. This is useful when 
the line is associated with an ACU used to 
place outgoing calls. 

The remaining calls are not available in vanilla version 7 
UNIX. In cases where arguments are required, they are 
described; arg should otherwise be given as 0. 



TIOCFLUSH 



TIOCSTI 

TIOCSBRK 
TIOCCBRK 
TIOCSDTR 
TIOCCDTR 
TIOCGPGRP 

TIOCSPGRP 

FIONREAD 



The second 
characters 
interfaces 



If arg is 0, all characters waiting in input 
or output queues are flushed. If arg is 
FREAD (defined in <sys/f ile.h>) , all charac- 
ters in the input queues are flushed. If arg 
is FWRITE (defined in <sys/f ile.h>) , all 
characters in the output queues are flushed. 

The argument is the address of a character 
which the system pretends was typed on the 
terminal. 

The break bit is set in the terminal. 

The break bit is cleared. 

Data terminal ready is set. 

Data terminal ready is cleared. 

Arg is the address of a word into which is 
placed the process group number of the con- 
trol terminal. 

Arg is a word (typically a process id) which 
becomes the process group for the control 
terminal. 

Returns in the long integer whose address is 
arg the number of immediately readable char- 
acters from the argument unit. This works 
for files, pipes, and terminals, but not 
(yet) for multiplexed channels. 

structure associated with each terminal specifies 

that are special in both the old and new terminal 

: The following structure is defined in 
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< sys / ioctl .h>, which is automatically included in < sgtty .h>; 



struct tchars { 

char t_intrc; 
char t_quitc; 
char t_startc] 
char t_stopc; 
char t_eofc; 
char t brkc; 

}; 



/* 
/* 
/* 
/* 
/* 
/* 



interrupt */ 

quit */ 

start output */ 

stop output */ 

end-of-file */ 

input delimiter (like nl) */ 



The default values for these characters are ^7, ^\, ^Q, '^S, 
•^D, and -1. A character value of -1 eliminates the effect 
of that character. The t brkc character, by default -1, 
acts like a new-line in that it terminates a 'line,' is 
echoed, and is passed to the program. The 'stop' and 
'start' characters may be the same, to produce a toggle 
effect. It is probably counterproductive to make other spe- 
cial characters (including erase and kill) identical. The 
applicable ioctl calls are: 

TIOCGETC Get the special characters and put them in the 
specified structure. 

TIOCSETC Set the special characters to those given in the 
structure. 

The third structure associated with each terminal is a local 
mode word; except for the LNOHANG bit, this word is inter- 
preted only when the new driver is in use. The bits of the 
local mode word are: 

LCRTBS 000001 Backspace on erase rather than echoing erase 
LPRTERA 000002 Printing terminal erase mode 
LCRTERA 000004 Erase character echos as 

backspace-space-backspace 
LTILDE 000010 Convert ~ to on output 

(for Hazeltine terminals) 
LMDMBUF 000020 Stop/start output when carrier drops 
LLITOUT 000040 Suppress output translations 
LTOSTOP 000100 Send SIGTTOU for background output 
LFLUSHO 000200 Output is being flushed 
LNOHANG 000400 Don't send hangup when carrier drops 
LETXACK 001000 Diablo style buffer hacking (un implemented) 
LCRTKIL 002000 BS-space-BS erase entire line on line kill 
LINTRUP 004000 Generate interrupt SIGTINT when input 

ready to read 
LCTLECH 010000 Echo input control chars as '"X, delete 

as '^T 
LPENDIN 020000 Retype pending input at next read or 

input character 
LDECCTQ 040000 Only '^Q restarts output after ^S, like DEC 
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systems 

The applicable ioctl functions are: 

TIOCLBIS Arg is the address of a mask which is the 
bits to be set in the local mode word. 

TIOCLBIC Arg is the address of a mask of bits to be 

cleared in the local mode word. 

TIOCLSET Arg is the address of a mask to be placed in 

the local mode word. 

TIOCLGET Arg is the address of a word into which the 

current mask is placed. 

The final structure associated with each terminal is the 
Itchars structure which defines interrupt characters for the 
new terminal driver. Its structure is: 

struct Itchars { 

char t_suspc; /* stop process signal */ 

char t_dstopc; /* delayed stop process signal */ 

char t_rprntc; /* reprint line */ 

char t_flushc; /* flush output (toggles) */ 

char t_werasec;/* word erase */ 

char t Inextc; /* literal next character */ 

}; 

The default values for these characters are ^Z, '^Y, -^R, '^O, 
^W, and '*'V. A value of -1 disables the character. 

The applicable ioctl functions are: 

TIOCSLTC Arg is the address of an Itchars structure which 
defines the new local special characters. 

TIOCGLTC Arg is the address of an Itchars structure into 
which is placed the current set of local special 
characters. 

FILES 

/dev/tty 

/dev/tty?? 

/dev/console 

SEE ALSO 

csh(l), stty(l), ioctl(2), signal(2), sigsys(2j), stty(2), 
newtty(4), getty(8), init(8) 

RESTRICTIONS 

Half-duplex terminals are not supported. 
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NAME 



a. out - assembler and link editor output 



SYNOPSIS 

♦include <a.out.h> 

DESCRIPTION , ^ . ^ , . , 

A. out is the output file of the assembler as(l) and the link 
editor ld(l). Both programs make a. out executable if there 
were no errors and no unresolved external references. Lay- 
out information as given in the include file for the PDPll 
is: 



/* 










* sees ID: %W% 


%G% 


*/ 








struct 


exec { 


/" 


' a. out 




int 


a_ 


magic; 




uns: 


igned 


a~ 


"text; 




uns: 


igned 


a" 


"data; 




uns: 


gned 


a_ 


^bss; 




uns] 


.gned 


a" 


'syms; 




uns 


.gned 


a' 


gentry; 




uns 


igned 


a' 


unused; 




uns 


Lgned 


a' 


"flag; 



/* magic number */ 

/* size of text segment */ 

/* size of initialized data 

/* size of unitialized data 

/* size of symbol table */ 

/* entry point */ 

/* not used */ 

/* relocation info stripped 



*/ 
*/ 



V 



}? 

#define NOVL 



struct 



}; 



ovlhdr { 

int max_ovl;/* maximum ovl size * 

unsigned ov siz[NOVL];/* size of i ' th overlay */ 



/ 



#define 


A MAGICl 


0407 


#def ine 


A MAGIC2 


0410 


#define 


A MAGIC3 


0411 


#define 


A MAGIC4 


0405 


#def ine 


A MAGIC5 


0430 


#def ine 


A MAGIC6 


0430 


#def ine 


A MAGIC7 


0431 



/* normal (I space only) */ 

/* read-only/shared text */ 

/* separated I&D */ 

/* overlay (NOT USED) */ 

/* overlay text kernel */ 

/* user overlay (shared text) */ 

/* user overlay (separated I&D) */ 

struct nlist { /* symbol table entry */ 

char n_name[8]; /* symbol name */ 
int n_type; /* type flag */ 
unsigned n_value; /* value */ 

}; 
/* 

* Macros that take exec structures as arguments and tell 

* whether the file has a reasonable magic number or 

* offset to text. 
V 
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#define N BADMAG(x) \ 



( ( ( X ) . a_mag i c ) 
( ( X ) . a_mag i c ) 
( (x) .a_magic) 
( ( X ) . a_mag i c ) 



=A_MAGIC1 && ((x).a_inagic) !=A_MAGIC2 && \ 

=A_MAGIC3 && ((x) .a_magic) !=A_MAGIC4 && \ 

=A_MAGIC5 SeSc ((x).a magic) !=A MAGIC6 S>& \ 
=A MAGIC7) 



#define N_OVMAG{x) \ 

(((x).a_magic)==A_MAGIC5 || ( (x) .a magic)==A MAGICS II 
((x).a_magic)==A_MAGIC7) 



#define N_TXTOFF(x) \ 

(N_OVMAG(x) ? sizeof (struct ovlhdr) 
: sizeof (struct exec)) 



+ sizeof (struct exec) \ 







/* values 


for 


#def ine 


N UNDF 





/* 


#define 


N ABS 


01 


/* 


#define 


N TEXT 


02 


/* 


#define 


N DATA 


03 


/* 


#define 


N ESS 


04 


/* 


#def ine 


N TYPE 


037 




#def ine 


N REG 


024 


/* 


#def ine 


N FN 


037 


/* 


#def ine 


N EXT 


040 


/* 


#define 


FORMAT 


"%06o" 


/* 



type flag */ 
undefined */ 
absolute */ 
text symbol */ 
data symbol */ 
bss symbol */ 

register name */ 
file name symbol 
external bit, or' 
to print a value 



*/ 
ed 
*/ 



in */ 



The file has four sections: a header, the program and data 
text, relocation information, and a symbol table (in that 
order). The last two may be empty if the program was loaded 
with the '-S' option of Id or if the symbols and relocation 
have been removed by strip Tl ) . 

In the header the sizes of each section are given in bytes 
but are even. The size of the header is not included in any 
of the other sizes. 

When an a. out file is loaded into core for execution, three 
logical segments are set up: the text segment, the data seg- 
ment (with uninitialized data, which starts off as all 
following initialized data), and a stack. The text segment 
begins at in the core image; the header is not loaded If 
the magic number in the header is 0407(8), it indicates that 
the text segment is not to be write-protected and shared, so 
the data segment is immediately contiguous with the text 
segment. If the magic number is 0410, the data segment 
begins at the first mod 8K byte boundary following the 
text segment, and the text segment is not writable by the 
program; if other processes are executing the same file 
they will share the text segment. If the magic number is 
411, the text segment is again pure, write-protected, and 
shared, and moreover instruction and data space are 
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^eoarated- the text and data segment both begin at location 
separated^ magic number is 0405, the text segment is over- 
laid on an ^existing (0411 or 0405) text segment and the 
existing data segment is preserved. 

The stack will occupy the highest possible locations in the 
core Image: from ^^0177776(8) and growing downwards. The 
stack is automatically extended as required. The data seg 
ment is only extended as requested by brk(2). 

The start of the text segment in the file is 020(8); the 
stlrt of the data segment i%020.St (the size of the text) 
thP start of the relocation information is 020+St+sa, tne 
s^arf of ?he s^bol table is 020.2(St.Sd) if the relocation 
information is present, 020+St+Sd if not. 

The layout of a symbol table entry and the principal flag 
valueftha? distinguish symbol types are given in the 
include file. Other flag values may occur if an assemoiy 
language program defines machine instructions. 

If a svmbol's type is undefined external, and the value 
field^s non-zero, the symbol is interpreted by the loader 
Id as the name of a common region whose size is indicated by 
the value of the symbol. 

The value of a word in the text or data portions which is 
not a ?e?erence to an undefined external symbol is exactly 
1-hai- value which will appear in core when the tiie is exe- 
cuted Ha word in the text or data portion involves a 
?eflr;nce to an undefined external symbol, as indicated by 
the relocation information for that word, then the value of 
the wo?d as stored in the file is an offset from the associ- 
ated external symbol. When the file is processed by the 
link editor and the external symbol becomes defined, the 
va?ue of the symbol will be added into the word in the file. 

If relocation information is present, it amounts to one word 
per word of program text or initialized data. There is no 
?eloca?ion information if the 'relocation info stripped 
flag in the header is on. 

Bits 3-1 of a relocation word indicate the segment referred 
to by the text or data word associated with the relocation 
word: 

000 absolute number 

002 reference to text segment 

004 reference to initialized data 

006 reference to uninitialized data (bss) 

010 reference to undefined external symbol 
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Bit of the relocation word indicate*? if i *.u ^ 
reference is relative to the pc (e?g!r'clr x' ) •' if o"" .V't 
the reference is to the actual symbo?* (e.g. ^ ^dr i$x'). ' 

The remainder of the relocation word rhif<! le; a\ 

symbol number in the ra^^ r^f 25?^ ? 5~*^ contains a 

SEE ALSO 

as(l), ld(l), nm(l) 
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NAME 



acct - execution accounting file 



SYNOPSIS 

# include <sys/acct.h> 



DESCRIPTION 
Acct (2) 



to be made 



file 
is a 



causes entries to be made into an accounting 
TKF' each process that terminates. The accounting file 
sequence of entries whose layout, as defined by the include 
file is: 



/* 

* SCCSID: @(#)acct.h 

*/ 

/* 

* Accounting structures 

*/ 



1.18/2/84 



struct 
{ 



}; 

extern 
extern 



acct 

char 

comp_t 

comp_t 

comp_t 

t ime_t 

short 

short 

short 

comp_t 

dev_t 

char 



struct 
struct 



Accounting command name */ 
Accounting user time */ 
Accounting system time */ 
Accounting elapsed time */ 
Beginning time */ 
Accounting user ID */ 
Accounting group ID */ 
average memory usage */ 
number of disk 10 blocks */ 
control typewriter */ 
Accounting flag */ 



acct acctbuf ; . 

inode *acctp;/* inode of accounting file */ 



ac_comm[10] ; 


/* 


ac_utime; 


/* 


ac_stime; 


/* 


ac etime; 


/* 


ac_btime; 


/* 


ac_uid; 


/* 


ac gid; 


/* 


ac_mem; 


/* 


ac_io; 


/* 


ac tty; 


/* 


ac flag; 


/* 



#define AFORK 
#define ASU 



01 
02 



/* has executed fork, but no exec */ 
/* used super-user privileges */ 



If the process does an exec(2), the first 10 characters of 
the filename appear in ac comm . The accounting flag contains 
bits indicating whether ~exicT 2) was ever accomplished, and 
whether the process ever had super-user privileges. 



SEE ALSO 

acct(2), sad) 
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NAME 

ar - archive (library) file format 

SYNOPSIS 

#include <ar.h> 

DESCRIPTION 

The archive command ar is used to combine several files into 

r^he u^u^^iftorid?^^' '"^^"^^ ^^ ^^^-^-^ tS^^^^Lch^^ 

A file produced by ar has a magic number at the start fnl 
ieldfr ^hl^S^n-^^'^"^"' /'I"' each preceded by 'a nil 
Ehe fnilude fufarer """^ """^^ '"^°"' " described i^ 



* 



/ 

* SCCSID: @(#)ar. hi. 011/12/83 
*/ 

#define ARMAG 0177545 
struct ar_hdr { 

char ar_name[14]; 

long ar_date; 

char ar_uid; 

char ar_gid; 

int ar_mode; 

long ar size; 
}; 



The name is a null-terminated string; the date i<! in <->,<. 
form of Mme(2); the user ID and g^oup ID are ni^berS- thi 
mode^xs a bit pattern per chmod(2) ;\he size is ^Snted Tn 

Telleln^%nli''\T n/°"^ boundary; a null byte is inserted 
reflect lllL^^L "^^^^^ary Nevertheless the size given 
reflects the actual size of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive 

SEE ALSO 

ard), ld(l), nm(l) 

RESTRICTIONS 

Coding user and group IDs as characters is a botch. 
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NAME 

core - format of core image file 

DESCRIPTION 

UNIX writes out a core image of a terminated process when 
any of various errors occur. See siqnal (2) for the list o£ 
reasons: the most common are memory violations, illegal 
instructions, bus errors, and user-generated quit signals. 
The core image is called 'core' and is written in the 
process's working directory (provided it can be; normal 
access controls apply) . 

The first 1024 bytes of the core image are a copy of the 
system's per-user data for the process, including the regis- 
ters as they were at the time of the fault; see the system 
listings for the format of this area. The remainder 
represents the actual contents of the user's core area when 
the core image was written. If the text segment is write- 
protected and shared, it is not dumped; otherwise the entire 
address space is dumped. 

In general the debugger adb(l) is sufficient to deal with 
core images. 

SEE ALSO 

adb(l), signal(2) 
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NAME 

cpio - format of cpio archive 

DESCRIPTION 

used^^^f!^ '^'"°^"'^' ^^^" ^^^ -° °P^^°" °^ °£i2(l) is not 

Struct { 

short h_magic, 

h_dev ; 
u_short h_ino , 
h_raod e , 
h_uid , 
h_gid ; 
short h_nlink, 

h_rdev , 
h_mtime[2], 
h_namesize , 
h_filesizeC2]; 
} Hdr- ^^^^ h_name[h_namesize rounded to word]; 

de'scribL'by:^'''^" '' "^^' ' '"^ ^^^^^ information is 

sscanf(Chdr,n6o%6o$6o%6o5t6o5S6o5J6o?6o?111o%6o%111o%s" 

&Sdr*h-nff°^HH"^^^?^^' &Hdr.h_ino, &Hdr.h i^ode, 
^TnL?- ',u?'^''j^-^'^' &Hdr.h_nlink, &Hdr.h-rdev 
&Longtime, &Hdr .h_namesize ,&Longfile ,Hdr .h_nime) ; 

^n&l^ and Lon^file are equivalent to Hdr. h mtime and 
Ml-hlilesize, respectively. The contents ^f-e ach fil e are 

tures arch?" '''r"\^' the array of varying length struc! 
tures, archive , together with other items describing the 

07J?67 Iootair''?r'-.°' M^^ °°"^^^"^ ^^^ °°"'ta"t 
lr.lXy't .i:Ts,.r^ '-^^^ ^"°^"^^"^ ''^ nuJ^byte-f Is 

TRli;E'R'.''°°Sn.o°Lw-n^^^^^ "^""^^ contains the name 
recorded wiVhhJ-f ^^^^^' directories, and the trailer are 
recorded with h filesize equal to zero. 

SEE ALSO 

cpiod ), find(l), stat(2). 
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NAME 

dir - format of directories 

SYNOPSIS 

# include <sys/dir.h> 

DESCRIPTION 

A directory behaves exactly like an ordinary file, save that 
no user may write into a directory. The fact that a file is 
a directory is indicated by a bit in the flag word of its 
i-node entry see, f ilsys (5) . The structure of a directory 
entry as given in the include file is: 

/* 
* SCCSID: @(#)dir. hi. 011/12/83 

*/ 
#ifndef DIRSIZ 
#define DIRSIZ14 
#endif 
struct direct 

{ 

ino_t d_ino; 

char d name[DIRSIZ] ; 

}; 

By convention, the first two entries in each directory are 
for '.' and '..'. The first is an entry for the directory 
itself. The second is for the parent directory. The mean- 
ing of '..' is modified for the root directory of the master 
file system and for the root directories of removable file 
systems. In the first case, there is no parent, and in the 
second, the system does not permit off-device references. 
Therefore in both cases '..' has the same meaning as '.'. 

SEE ALSO 

filsys{5) 
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NAME 



dump, ddate - incremental dump format 



SYNOPSIS 

# include <sys/types.h> 

finclude <sys/ino.h> 

# include <dumprestor.h> 

DESCRIPT^ION 

Tapes used by dump and restor (l) contain: 

a header record 

two groups of bit map records 

a group of records describing directories 

a group of records describing files 

The format of the header record and of the first record of 
each description as given in the include file <dumprestor.h> 
is: '^ - 



/* 






* SCCSID: (i(#)dumprestor.hl.01] 


*/ 






#def ine 


NTREC 


20 


#def ine 


MLEN 


16 


#ifdef 




RESTOR40 


#def ine 




MSIZ3072 


#else 






#def ine 


MSIZ 


4096 


#endif 






#def ine 


TS TAPE 


1 


#def ine 


TS I NODE 


2 


#def ine 


TS BITS 


3 


#def ine 


TS ADDR 


4 


#def ine 


TS END 


5 


#def ine 


TS CLRI 


6 


#def ine 


MAGIC 


{int)60011 


#def ine 


CHECKSUM 


(int)84446 


struct 
{ 

int 




spcl 




c_type; 


time_t 


c_date; 


time t 


c_ddate; 


int 




c_volume; 


daddr_t 


c_tapea; 


ine 


>_t 


c_i number; 


int 




c_magic; 


int 




c checksum; 


struct 


dTnodec_d i node ; 


int 




c count; 


cha 


ir 


c addr[BSIZE]; 
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} spcl; 

struct idates 

{ 

char id_name[16] ; 

char id_incno; 

time t id_ddatej 
}; 

NTREC is the number of 512 byte records in a physical tape 
block. MLEN is the number of bits in a bit map word. MSIZ 
is the nvimber of bit map words. 

The TS entries are used in the c type field to indicate 
what sort of header this is. The types and their meanings 
are as follows: 

TS_TAPE Tape volume label 
TS_INODE 

A file or directory follows. The c dinode field is 

a copy of the disk inode and contains bits telling 

what sort of file this is. 
TS_BITS A bit map follows. This bit map has a one bit for 

each inode that was dumped. 
TS_ADDR A subrecord of a file description. See c addr 

below. 
TS_END End of tape record. 
TS_CLRI A bit map follows. This bit map contains a zero bit 

for all inodes that were empty on the file system 

when dumped. 
MAGIC All header records have this number in c magic . 
CHECKSUM 

Header records checksum to this value. 

The fields of the header structure are as follows: 

c_type The type of the header. 

c_date The date the dump was taken. 

c_ddate The date the file system was dumped from. 

c_volume The current volume number of the dump. 

c_tapea The current number of this (512-byte) record. 

c_i number 

The number of the inode being dumped if this is of 

type TS INODE . 
c_magic This contains the value MAGIC above, truncated as 

needed. 
c_checksum 

This contains whatever value is needed to make the 

record sum to CHECKSUM . 
c_dinode This is a copy of the inode as it appears on the 

file system; see f ilsys (5) . 
c count The count of characters in c addr. 
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c_addr An array of characters describing the blocks of the 
dumped file. A character is zero if the block 
associated with that character was not present on 
the file system, otherwise the character is non- 
zero. If the block was not present on the file 
system, no block was dumped; the block will be 
restored as a hole in the file. If there is not 
sufficient space in this record to describe all of 
the blocks in a file, TS ADDR records will be scat- 
tered through the file, each one picking up where 
the last left off. ^ f 

Each volume except the last ends with a tapemark (read as an 
end of file). The last volume ends with a TS EN D record and 
then the tapemark. 

The structure idates describes an entry of the file 
/etc/ddate where dump history is kept. The fields of the 
structure are: 

id_name The dumped filesystem is '/dev/ id nam ' . 
id_incno The level number of the dump tape; see*dump(l) 
id_ddate The date of the incremental dump in system format 
see types (5) . 

FILES 

/etc/ddate 

SEE ALSO 

dump(l), dumpdir(l), restor(l), filsys(5), types(5) 
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NAME 

environ - user environment 

SYNOPSIS 

extern char **environ; 

DESCRIPTION 

An array of strings called the 'environment' is made avail- 
able by exec (2) when a process begins. By convention these 
strings have~the form 'name=value' . The following names are 
used by various commands: 

PATH The sequence of directory prefixes that sh, time, 
nice(l), etc., apply in searching for a file known by 
arTTncomplete path name. The prefixes are separated by 
':'• Loqin (l) sets PATH=: /bin: /usr/bin. 

HOME A user's login directory, set by login (1) from the 
password file passwd (5) . 

TERM The kind of terminal for which output is to be 
prepared. This information is used by commands, such 
as nroff or plot (l) , which may exploit special terminal 
capabilities. See term (7) for a list of terminal 
types. 

Further names may be placed in the environment by the export 
command and 'name=value' arguments in sh(l), or by exec (2) . 
It is unwise to conflict with certain Shell variables that 
are frequently exported by '.profile' files: MAIL, PSl, PS2, 
IFS. 

SEE ALSO 

exec(2), sh(l), term(7), login(l), termcap(5) 
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NAME 

filsys, flblk, ino - format of file system volijme 

SYNOPSIS 

# include <sys/types.h> 
# include <sys/flbk.h> 
#include <sys/f ilsys.h> 
tinclude <sys/ino.h> 

DESCRIPTION 

Every file system storage volume (e.g. RL disk, RP disk, HP 
disk, DECtape reel) has a common format for certain vital 
information. Every such volume is divided into a certain 
number of 512-byte blocks. Block is unused and is avail- 
able to contain a bootstrap program, pack label, or other 
information. 

Block 1 is the super block . The layout of the super block as 
defined by the include file < sys / f ilsys .h> is: 

/* 

* SCCSID: (a(#)filsys.h 1.3 8/18/84 
*/ 

finclude <sys/localopts.h> 
/* 

* Structure of the super-block 
*/ 

struct filsys { 

unsigned short s_isi2e; /* size in blocks of i-list */ 

daddr_t s_fsize; /* size in blocks of entire volume */ 

short s_nfree; /* number of addresses in s free */ 

daddr_t s_f ree[NICFREE] ;/* free block list */ 

short s_ninode; /* number of i-nodes in s inode */ 

ino_t s_inode[NICINOD];/* free i-node list */ "" 

char s_flock; /* lock during free list 

manipulation */ 
char s_ilock; /* lock during i-list manipulation */ 
char s_fmod; /* super block modified flag */ 
char s_ronly; /* mounted read-only flag */ 
time_t s_time; /* last super block update */ 
/* set by mkfs, updated by fsck, not used by system */ 
daddr_t s_tfree; /* total free blocks*/ 
ino_t s_t inode; /* total free inodes */ 
/* set by mkfs, used by fsck to salvage free lists */ 
short s_m; /* interleave - free list spacing */ 
short s_n; /* interleave - blocks per cylinder */ 
/* set by mkfs and/or labelit, printed by fsck 

and labelit */ 
char s_fname[6]; /* file system name */ 
char s_fpack[6]; /* file system pack name */ 
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#ifdef BUFFERS . , . *, 

ino t s lasti; /* start place for circular search */ 

inolt s>behind; /* est # free xrtodes before s_lasti */ 

# end if BUFFERS 

}; 

fifdef MAPMOUNT 

/* 

* flags to avoid locking problems in alloc, free, ialloc 

*/ 
#define S_BUSY 01 /* alloc in progress */ 

#define S_WANTED 02 /* want to alloc */ 
#endif 

S isize is the address of the first block after the i-list, 
which starts just after the super-block, in block 2. Thus 
is i-list is s isize -2 blocks long. S fsize is the address 
of the first block not potentially available for allocation 
to a file. These numbers are used by the system to check 
for bad block addresses; if an 'impossible' block address is 
allocated from the free list or is freed, a diagnostic is 
written on the on-line console. Moreover, the free array is 
cleared, so as to prevent further allocation from a presum- 
ably corrupted free list. 

The free list for each volume is maintained as follows. The 
s free array contains, in s freeCl], ••* „,^' 
s freeCs nfree-1], up to NICFREE free block ntambers. NIC- 
FREE ii — a configuration constant. S free lOJ is the block 
address of the head of a chain of blocks constituting the 
free list. The layout of each block of the free chain as 
defined in the include file < sys / fblk .h> is: 

/* 
* SCCSID: (a(#)fblk.h 1.0 11/12/83 

*/ 
struct fblk 

{ 

int df_nfree; 
daddr_t df_f ree[NICFREE] ; 

}; 

The fields df nfree and df free in a free block are used 
exactly like i~nfree and s free in the super block. To 
allocate a blockl decrement s nfree , and the new block 
number is s free [ s nfree ]. If the new block address is 0, 
there are no blocks left, so give an error. If s nfree 
became 0, read the new block into s nfree and s free . To 
free a block, check if s nfree is NICFREE; if so, copy 
s nfree and the s free array into it, write it out, and set 
s nfree to 0. In any event set s free [ s nfree ] to the freed 
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block's address and increment s nfree . 

S ninode is the number of free i-numbers in 4-h« ^ • ^ 

?^f^??!^ ^"^ s ilock are flags maintained in the core conv of 

S time is the last time the suoer-block of fho f^i« 

was changed During a reboot^'^Itlie of the super-blo^ffor 

the^root fxle system is used to^^Tthe systemTIdea°Sf the 

cu^r^i^lf mfTMifl4d^^^^' ^"^^ ^^' ^-^^ -« not 

blS^^r^ ^SoLf ^' JJ'^k'^^ ^*^°^^9e for i-nodes begins in 

block T nonS 9 •^''^ ^* ^'y^^^ ^°''9' ^° 8 °f them fit into S 
block, i-node 2 is reserved for the root directory of tho 

F^ih .^^^^^^' ^""^ n° other i-number has a built-in meaning 
Each i-node represents one file The foriTi;,f of ^^ • ^ ^* 
given in the include file <s^/ino!h> [si '~"°^^ ^^ 

/* 

* SCCSID: @(#)ino.h l.O 11/12/83 
*/ 

/* 

* Inode structure as it appears on 

* a disk block. 
*/ 

struct dinode 
{ 

unsigned short di_mode;/* mode and type of file */ 

^hor^ H--"-i"^' /* "^^^^ °f links to f!le V 
short di_uid; /* owner's user id */ 
short dx_gid; /* owner's group id */ 
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off_t 
char 
t ime_t 
t ime_t 
time t 



di size; 
di_addr[40]; 
di_atime; 
di_nitime; 
di ctime; 



/* niimber of bytes in file 
/* disk block addresses */ 
/* time last accessed */ 
/* time last modified */ 
/* time created */ 



'/ 



}; 

#def ine 

/* 
* the 
* 
* 

*/ 
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/* 8 inodes per block */ 



40 address bytes: 
39 used; 13 addresses 
of 3 bytes each. 



Di mode 
the St 



tells 
mode 



Di uid 
the 
the 



IS 



are 



the kind of file; it is encoded identically to 
field of Stat (2). Di nlink is the number of 
directory entries Uinks) that refer to this i-node. 
and di gid are the owner's user and group IDs. Size 
number of bytes in the file. Di atime and di mtime 
times of last access and modification of the file contents 
(read, write or create) (see times(2)); Di ctime records the 
time of last modification to the inode or to the file, and 
is used to determine whether it should be dumped. 

Special files are recognized by their modes and not by i- 
number. A block-type special file is one which can poten- 
tially be mounted as a file system; a character-type special 
file cannot, though it is not necessarily character- 
oriented. For special files, the di addr field is occupied 
by the device code (see types (5)). The device codes of 
block and character special files overlap. 

Disk addresses of plain files and directories are kept in 
the array di addr packed into 3 bytes each. The first 10 
addresses specify device blocks directly. The last 3 
addresses are singly, doubly, and triply indirect and point 
to blocks of 128 block pointers. Pointers in indirect 
blocks have the type daddr t (see types (5)) . 

For block b in a file to exist, it is not necessary that all 
blocks lesi than b exist. A zero block number either in the 
address words of the i-node or in an indirect block indi- 
cates that the corresponding block has never been allocated. 
Such a missing block reads as if it contained all zero 
words. 



SEE ALSO , , ,^, 

icheck(l), dcheck(l), dir(5), mount(l), stat(2) 
ULTRIX-11 System Management Guide, Chapter 1 
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NAME 



fstab - file 



system table 



DESCRIPTION 

The fstab contains information about file 
used by various syst( 



systems. It is 



u=.«u i,y various system commands to obtain a default araument 
terns. control mounting and dismounting of fite^ys- 



Each line of 
lows: 



the fstab describes one file system, as fol- 



special:directory:mode 



Special IS the special filename for the file system Direc- 
tory IS the name of the directory where the file syitem will 
be mounted. Mode is the access mode of the life lyst^m 

thP^nr''% °K •^^'^ °"^y- setting the mode to -xx'clSles 
the entry to be ignored. The order of entries in the fs?«h 
IS important. Read ULTRIX-11 System Management Guide ^ 



FILES 



¥ir^r> AC Q c w-*^xx« j. x oysteni Management Guide. 

Us us;g4? ^ '"°'"^ complete description of the fst|b 

/etc/fstab 



and 



SEE ALSO 

min^i'i?''!^^: fsck(lm), mount(lm), quot(lm) 
ULTRIX-11 System Management Guide, Section 4.1 
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NAME 



gettytab - terminal configuration data base 



SYNOPSIS 

/etc/gettytab 

DESCRIPTION 



Gettytab is a simplified version of the termcap (5) data base 
used to describe terminal lines. The initial terminal login 
s, getty (8) , accesses the gettytab file each time 
, allowing simpler reconfiguration of terminal cha 



process 

starts. 

teristics. Each entry in the data base is used to 

one class of terminals. 



It 

rac- 

describe 



There is a default terminal class, default , that is used to 
set global defaults for all other classes. (That is, the 
default entry is read, then the entry for the class required 
is used to override particular settings.) 

CAPABILITIES 

Refer to termcap (5) for a description of the file layout. 
The default column below lists defaults obtained if there is 
neither an entry in the table for that name, nor one in the 
special default table. 

Description 

auto-baud on carriage-return 

instead of break 
terminal uses any parity 
backspace delay 
alternate end of line character 

(input break) 
use crt backspace mode 
carriage-return delay 
use crt erase algorithm 
use crt kill algorithm 
console - add \n after login prompt 
delayed suspend character 
leave echo OFF 
terminal uses even parity 
erase character 
end of text (EOF) character 
form-feed (vertical motion) delay 
output flush character 
do NOT hangup line on last close 
terminal has real tabs 
ignore garbage characters in 

login name 
initial (banner) message 
interrupt character 
input speed 
kill character 



Name 


Type 


Default 


ab 


bool 


false 


ap 


bool 


false 


bd 


num 





bk 


str 


0377 


cb 


bool 


false 


cd 


num 





ce 


bool 


false 


ck 


bool 


false 


CO 


bool 


false 


ds 


str 


^Y 


ec 


bool 


false 


ep 


bool 


false 


er 


str 


^? 


et 


str 


^D 


fd 


num 





fl 


str 


^0 


he 


bool 


false 


ht 


bool 


false 


ig 


bool 


false 


im 


str 


NULL 


in 


str 


^C 


is 


num 


unused 


kl 


str 


^U 
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Ic 


bool 


false 


Im 


str 


login: 


In 


str 


^V 


lo 


str 


/bin/login 


nd 


niMii 





nl 


bool 


false 


nx 


str 


default 


op 


bool 


false 


OS 


num 


unused 


pe 


bool 


false 


qu 


str 


'^X 


rp 


str 


-^R 


rw 


bool 


false 


sp 


num 


1200 


su 


str 


^Z 


tc 


str 


none 


uc 


bool 


false 


we 


str 


^W 


xc 


bool 


false 


xf 


str 


'^S 


xn 


str 


"Q 
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terminal has lower case 

login prompt 

"literal next" character 

program to exec when name obtained 

newline (line-feed) delay 

terminal has (or might have) a 

newline character 
next table (for auto speed selection) 
terminal uses odd parity 
output speed 

use printer (hard copy) erase algorithm 
quit character 
line retype character 
do NOT use raw for input, use cbreak 
line speed (input and output) 
suspend character 
table continuation 
terminal is known upper case only 
word erase character 
do NOT echo control chars as '^X 
XOFF (stop output) character 
XON (start output) character 

If no line speed is specified, speed will not be altered 
from that which prevails when getty is entered. Specifying 
an input or output speed will override line speed for stated 
direction only. 

Should getty receive a null character (presumed to indicate 
a line break) it will rescan using the table name indicated 
by the nx entry. If there is none, it will re-use its origi- 
nal table name. Using ab, getty will autobaud on a 
carriage-return instead of an input break. This is useful 
for lines that are connected via a switch. 

Delays with values 0, 1, 2, and 3 are interpreted as choos- 
ing that particular delay algorithm from the driver. 

Output from getty is even parity unless op is specified. Op 
may be specified with ap to allow any parity on input, but 
generate odd parity output. Note: this only applies while 
getty is being run, terminal driver limitations prevent a 
more complete implementation. Getty does not check parity 
of input characters in RAW mode. 

SEE ALSO 

termcap(5), getty(8). 
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NAME 

group - group file 

DESCRIPTION 

Group contains for each group the following information: 

group name 

encrypted password 

numerical group ID 

a comma separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; 
Each group is separated from the next by a new-line. If the 
password field is null, no password is demanded. 

This file resides in directory /etc. Because of the 
encrypted passwords, it can and does have general read per- 
mission and can be used, for example, to map numerical group 
id's to names. 

FILES 

/etc/group 

SEE ALSO 

newgrp(l), cryptO), passwd(l), passwd(5) 



'^^^'^ MTAB(S) 



NAME 

mtab - mounted file system table 

DESCRIPTION 

Mtab resides in directory / etc and contains a table of dev- 
ices mounted by the mount command. Umount removes entries. 

Each entry is 64 bytes long; the first 32 are the null- 
padded name of the place where the special file is mounted; 
the second 32 are the null-padded name of the special file 
The special file has all its directories stripped away; that 
is, everything through the last V is thrown away. 

This table is present only so people can look at it it 
does not matter to mount if there are duplicated entries nor 
to umount if a name cannot be found. 

FILES 

/etc/mtab 

SEE ALSO 

mount ( 1 ) 
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NAME 



passwd - password file 



DESCRIPTION 

Passvd contains for each user the following information; 

name (login name, contains no upper case) 

encrypted password 

numerical user ID 

numerical group ID 

GCOS job number, box number, optional GCOS user- id 

initial working directory 

program to use as Shell 

This is an ASCII file. Each field within each user's entry 
is separated from the next by a colon. The GCOS field is 
used only when communicating with that system, and in other 
installations can contain any desired information. Each 
user is separated from the next by a new-line. If the pass- 
word field is null, no password is demanded; if the Shell 
field is null, the Shell itself is used. 

This file resides in directory /etc. Because of the 
encrypted passwords, it can and does have general read per- 
mission and can be used, for example, to map numerical user 
id's to names. 



FILES 



/etc/passwd 



SEE ALSO 

getpwentO), logind), crypt (3), passwd(l), group{5) 
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NAME 



phones - remote host phone number data base 



DESCRIPTION 

The file /etc/phones contains the system-wide private phone 
numbers for the tjjodc) program. This file is normally 
unreadable, and so may contain privileged information. The 
format of the file is a series of lines of the form: 
<system-name>[ \t]*<phone-number>. The system name is one 
of those defined in the remote (5) file and the phone number 
IS constructed from [0123456789-=*%]. The '=' and '*' char- 
acters are indicators to the auto call units to pause and 
wait for a second dial tone (when going through an 
exchange). The '=' is required by the DF02-AC and the '*• 
is required by the BIZCOMP 1030. 

Only one phone number per line is permitted. However, if 
more than one line in the file contains the same system name 
tip (lC) will attempt to dial each one in turn, until it 
establishes a connection. 



FILES 

/etc/phones 

SEE ALSO 

tip(lC), remote(5) 
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NAME 

plot - graphics interface 

DESCRIPTION 

Files of this format are produced by routines described in 
plot (3) , and are interpreted for various devices by commands 
described in plot (l) . A graphics file is a stream of plot- 
ting instructions. Each instruction consists of an ASCII 
letter usually followed by bytes of binary information. The 
instructions are executed in order. A point is designated 
by four bytes representing the x and y values; each value is 
a signed integer. The last designated point in an 1, m, n, 
or p instruction becomes the 'current point' for the next 
instruction. 

Each of the following descriptions begins with the name of 
the corresponding routine in plot (3) . 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point 
given by the next four bytes. See plot (l) . 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point given by the next four 
bytes to the point given by the following four bytes. 

t label: Place the following ASCII string so that its first 
character falls on the current point. The string is ter- 
minated by a newline. 

a arc: The first four bytes give the center, the next four 
give the starting point, and the last four give the end 
point of a circular arc. The least significant coordi- 
nate of the end point is used only to determine the qua- 
drant. The arc is drawn counter-clockwise. 

c circle: The first four bytes give the center of the cir- 
cle, the next two the radius. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a newline, as 
the style for drawing further lines. The styles are 
'dotted,' 'solid,' ' longdashed, ' 'shortdashed, ' and 'dot- 
dashed.' Effective only in plot 4014 and plot ver. 

s space: The next four bytes give the lower left corner of 
the plotting area; the following four give the upper 
right corner. The plot will be magnified or reduced to 
fit the device as closely as possible. 
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Space settings that exactly fill the plotting area with 
unity scaling appear below for devices supported by the 
filters of plot (l). The upper limit is just outside the 
plotting area. In every case the plotting area is taken 
to be square; points outside may be displayable on dev- 
ices whose face isn't square. 

4014 space(0, 0, 3120, 3120) 

ver space(0, 0, 2048, 2048) 

300, 300s space(0, 0, 4096, 4096) 

450 space(0, 0, 4096, 4096) 

SEE ALSO 

plot(l), plot(3), graph(l) 
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NAME 



printcap - printer capability data base 



SYNOPSIS 

/etc/printcap 

DESCRIPTION 

Printcap is a simplified version of the termcap (5) data base 
used to describe line printers. The spooling system 
accesses the printcap file every time it is used, allowing 
dynamic addition and deletion of printers. Each entry in 
the data base is used to describe one printer. This data 
base may not be substituted for, as is possible for termcap , 
because it may allow accounting to be bypassed. 

The default printer is normally l£, though the environment 
variable PRINTER may be used to override this. Each spool- 
ing utility supports an option, -P pr inter , to allow explicit 
naming of a destination printer. 

CAPABILITIES 

Refer to termcap (5) for a description of the file layout. 

Description 

name of accounting file 

if Ip is a tty, set the 

baud rate (ioctl call) 
name of printer daemon 
if Ip is a tty, clear 

flag bits (sgtty.h) 
string to send for a form feed 
print a form feed when device 

is opened 
like 'fc' but set bits 
error logging file name 
name of lock file 
device name to open for output 
maximum file size (in BUFSIZ 

blocks), zero = unlimited 
suppress printing of control char- 
acters when using an output filter 
name of output filtering program 
page length (in lines) 
page width (in characters) 
open the printer device for 

reading and writing 
spool directory 
suppress form feeds 
suppress printing of burst 

page header 
trailer string to print when 

queue empties 



Name 
af 


Type 
str 


Default 
NULL 


br 


n\im 


none 


dn 

fc 


str 
num 


'/usr/lib/lpd' 



ff 
fo 


str 
bool 


'\f 
false 


fs 

If 

lo 

Ip 

mx 


nxjm 
str 
str 
str 
niim 




Vdev/console' 

■lock' 

'/dev/lp' 

1000 


nc 


bool 


false 


of 

pl 
pw 

rw 


str 
num 
num 
bool 


NULL 
66 
132 
false 


sd 
sf 
sh 


str 

bool 

bool 


' /usr/spool/lpd' 

false 

false 



tr 



str 



NULL 
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*^ "^ if Ip is a tty, clear local 

mode bits (tty (4)) 
^s num like 'xc' but set bits 

Error messages sent to the console have a carriage return 
and a line feed appended to them, rather than just a line 
feed. 

SEE ALSO 

Ipq(l), Ipr(l), Iprm(l), termcap{5), lpd(8) 
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NAME 

remote - remote host description file 

DESCRIPTION 

The systems known by tip(lC) and their attributes are stored 
in an ASCII file which is structured somewhat like the 
termcap (5) file. Each line in the file provides a descrip- 
tion for a single system . Fields are separated by a colon 
(':'). Lines ending m a \ character with an immediately 
following newline are continued on the next line. 

The first entry is the name{s) of the host system. If there 
is more than one name for a system, the names are separated 
by vertical bars. After the name of the system comes the 
fields of the description. A field name followed by an '=' 
sign indicates a string value follows. A field name fol- 
lowed by a '#' sign indicates a following numeric value. 



Entries named 'tip*' and 'cu*' are used as default entries 
by tip , and the cu interface to tip , as follows. When tip 
is invoked with only a phone number, it looks for an entry 
of the form 'tip300', where 300 is the baud rate with which 
the connection is to be made. When the cu interface is 
used, entries of the form 'cuSOO' are used. 

CAPABILITIES 

Capabilities are either strings (str), numbers (num) , or 
boolean flags (bool). A string capability is specified by 
capabi 1 i ty = value ; e.g. 'dv=/dev/harris' . A numeric capabil- 
ity IS specified by capabi lity # value ; e.g. 'xa#99'. A 
boolean capability is specified by simply listing the capa- 
bility. 

at (str) Auto call unit type. 

br (num) The baud rate used in establishing a connection 
to the remote host. This is a decimal number. The 
default baud rate is 300 baud. 

cm (str) An initial connection message to be sent to the 
remote host. For example, if a host is reached through 
port selector, this might be set to the appropriate 
sequence required to switch to the host. 

cu (str) Call unit if making a phone call. Default is the 
same as the 'dv' field. 

di (str) Disconnect message sent to the host when a 
disconnect is requested by the user. 

ds (num) The baud rate used for dialing to the remote 
host, Used for the DF03 modem which can have the dial 
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speed different than the baud rate. This is a decimal 
number. By default this is the same as the baud rate. 



du 



(bool) This host is on a dial-up line. 



dv (str) UNIX device(s) to open to establish a connection. 
If this file refers to a terminal line, tip(lC) 
attempts to perform an exclusive open on the device to 
insure only one user at a time has access to the port. 

el (str) Characters marking an end-of-line. The default is 
NULL. '~' escapes are only recognized by tip after one 
of the characters in 'el', or after a carriage-return. 

fs (str) Frame size for transfers. The default frame size 
is equal to BUFSIZ. 

hd (bool) The host uses half-duplex communication, local 
echo should be performed. 

ie (str) Input end-of-file marks. The default is NULL. 

oe (str) Output end-of-file string. The default is NULL. 
When tj£ is transferring a file, this string is sent at 
end-of-file. 

pa (str) The type of parity to use when sending data to 
the host. This may be one of 'even', 'odd', 'none' 
•zero' (always set bit 8 to zero), 'one' (always set 
bit 8 to 1). The default is even parity. 

pn (str) Telephone number (s) for this host. If the tele- 
phone number field contains an @ sign, tip searches the 
file /etc/ phones file for a list of telephone numbers; 
c.f . phones ( 5 ) . 

tc (str) Indicates that the list of capabilities is con- 
tinued in the named description. This is used pri- 
marily to share common capability information. 

Here is a short example showing the use of the capability 
continuation feature: 

UNIX-1200:\ 

:dv=/dev/cauO : el='^D'^U'^C'^S^Q'^0@ : du: at=ventel : ie=#$% : oe=^D: br#1200 • 
arpavax|ax:\ 

:pn=7654321%:tc=UNIX-1200 



REM0TE{5) REM0TE(5) 



FILES 

/etc/remote 

SEE ALSO 

tip(lC), phones{5) 
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NAME 

sccsfile - format of SCCS file 

DESCRIPTION 

An SCCS file is an ASCII file. It consists of six logical 
parts: the checksum , the delta table (contains information 
about each delta), user names (contains login names and/or 
numerical user IDs of users who may add deltas), flags (con- 
tains definitions of internal keywords), comments (contains 
arbitrary descriptive information about the file), and the 
bodY (contains the actual text lines intermixed with control 
lines) . 

Throughout an SCCS file there are lines which begin with the 
ASCII SOH (start of heading) character (octal 001). This 
character is hereafter referred to as 'the control charac- 
ter and will be represented graphically as 'Q'. Any line 
described below which is not depicted as beginning with the 
control character is prevented from beginning with the con- 
trol character. 

Entries of the form 'DDDDD' represent a five digit strinq (a 
number between 00000 and 99999). 

Each logical part of an SCCS file is described in detail 
below. 

Checksum. The checksum is the first line of an SCCS file 
The form of the line is: 

QhDDDDD 
The value of the checksum is the sum of all characters 
except those of the first line. The '@h' provides a 'maqic 
number' of (octal) 064001. 

Delta table. The delta table consists of a variable number 
of entries of the form: 

@S DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
Q 1 DDDDD ... 
(ix DDDDD . . . 
@g DDDDD . . . 
@m <MR number> 



@c <comments> . . . 

@e 
The first line (@s) contains the number of lines 
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inserted/deleted/unchanged respectively. The second line 
(@d) contains the type of the delta (currently, normal: 'D', 
and removed: 'R'), the SCCS ID of the delta, the date and 
time of creation of the delta, the login name corresponding 
to the real user ID at the time the delta was created, and 
the serial numbers of the delta and its predecessor, respec- 
tively. 

The §i, @x, and (ig lines contain the serial numbers of del- 
tas included, excluded, and ignored, respectively. These 
lines are optional. 

The @m lines (optional) each contain one MR number associ- 
ated with the delta; the @c lines contain comments associ- 
ated with the delta. 

The @e line ends the delta table entry. 

User names . The list of login names and/or numerical user 
IDs of users who may add deltas to the file, separated by 
newlines. The lines containing these login names and/or 
numerical user IDs are surrounded by the bracketing lines 
'@u' and '@U'. An empty list allows anyone to make a delta. 

Flags . Keywords used internally (see admin(I) for more 
information on their use). Each flag line takes the form: 

@f <flag> <optional text> 
The following flags are defined: 

@f t <type of program> 

@f V <program name> 

@f i 

@f b 

§f m <module name> 

@f f <floor> 

@f c <ceiling> 

@f d <default-sid> 

@f n 
The 't' flag defines the replacement for the %Y% identifica- 
tion keyword. The W flag controls prompting for MR 
numbers in addition to comments; if the optional text is 
present it defines an MR number validity checking program. 
The 'i' flag controls the warning/error aspect of the 'No id 
keywords' message. When the 'i' flag is not present, this 
message is only a warning; when the 'i' flag is present, 
this message will cause a 'fatal' error (the file will not 
be gotten, or the delta will not be made). When the 'b' 
flag is present the keyletter may be used on the get command 
to cause a branch in the delta tree. The 'm' flag defines 
the first choice for the replacement text of the %M% iden- 
tification keyword. The 'f flag defines the 'floor' 
release; the release below which no deltas may be added. 
The 'c' flag defines the 'ceiling' release; the release 
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above which no deltas may be added. The 'd' flag defines 
the default SID to be used when none is specified on a qet 
conimand. The 'n' flag causes delta to insert a 'null' delta 
(a delta that applies no changes) in those releases that are 
skipped when a delta is made in a new release (e.g., when 
delta 5.1 IS made after delta 2.7, releases 3 and 4 are 
skipped). The absence of the 'n' flag causes skipped 
releases to be completely empty. 

Comments. Arbitrary text surrounded by the bracketing lines 
@t and ;@T'. The comments section typically will contain 
a description of the file's purpose. 

Bod^. The body consists of text lines and control lines 
Text lines don't begin with the control character, control 
lines do. There are three kinds of control lines: insert 
delete, and end, represented by: ' 

01 DDDDD 

@D DDDDD 

QE DDDDD 
respectively. The digit string is the serial number 
corresponding to the delta for the control line. 

SEE ALSO 

get(l), delta(l), admin(l), prt{l) 

An Introduction to the Source Code Control System by Eric 
Allman. * 
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NAME 

tar - tape archive format 

DESCRIPTION 

The tar command dxomps files to and extracts files from 
magtape in tape archive format. Unlike t£ tapes, tar tapes 
have no provision for a bootstrap program. The record size 
for tar tapes is always a multiple of 512 bytes. The most 
common blocking factors are one and 20. 

Tape archive format consists of a header record followed by 
the contents of the file. The header record has the follow- 
ing structure: 



SEE 



fdefine TBLOCK 


512 


#define NBLOCK 


20 


#define NAMSIZ 


100 


union hblock { 




char dummy [ TBLOCK ] ; 


struct header { 


char 


name[NAMSIZ]; 


char 


mode[8] ; 


char 


uid[8]; 


char 


gid[8]; 


char 


size[12]; 


char 


mtime[12] ; 


char 


chksiam[8] ; 


char 


linkf lag; 


char 


linkname [NAMSIZ]; 


char 


rdev[6]; /* file 


} dbuf; 




} dblock, tbuf [NBLOCK]; 


LSO 
tar(l) 





type */ 
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NAME 



termcap - terminal capability data base 



SYNOPSIS 

/etc/termcap 

DESCRIPTION 

Termcap is a data base describing terminals, used, e.g., by 
vi(l) and cursesO). Terminals are described in termcap by 
giving a set of capabilities which they have"^ and by 
describing how operations are performed. Padding require- 
ments and initialization sequences are included in termcap . 

Entries in termcap consist of a nxomber of ' : ' separated 
fields. The first entry for each terminal gives the names 
which are known for the terminal, separated by 'I' charac- 
ters. The first name is always 2 characters long and is 
used by older version 6 systems which store the terminal 
type in a 16 bit word in a systemwide data base. The second 
name given is the most common abbreviation for the terminal, 
and the last name given should be a long name fully identi- 
fying the terminal. The second name should contain no 
blanks; the last name may well contain blanks for readabil- 
ity. 

CAPABILITIES 

(P) indicates padding may be specified 

(P*) indicates that padding may be based on no. lines affected 



Name 


Type 


Pad? 


ae 


str 


(P) 


al 


str 


(P*) 


am 


bool 




as 


str 


(P) 


be 


str 




bs 


bool 




bt 


str 


(P) 


bw 


bool 




CC 


str 




cd 


str 


(P*) 


ce 


str 


(P) 


ch 


str 


(P) 


cl 


str 


(P*) 


cm 


str 


(P) 


CO 


num 




cr 


str 


(P*) 


cs 


str 


(P) 


cv 


str 


(P) 


da 


bool 




dB 


num 




db 


bool 




dC 


num 





set 



Description 

End alternate character 

Add new blank line 

Terminal has automatic margins 

Start alternate character set 

Backspace if not '^H 

Terminal can backspace with '^H 

Back tab 

Backspace wraps 

Command char in 

Clear to end of 

Clear to end of 

Like cm but horiz motion only. 

Clear screen 

Cursor motion 

Number of columns in a line 

Carriage return, (default '^M) 

Change scrolling region (vtlOO) 

Like ch but vertical only. 

Display may be retained above 

Number of millisec of bs delay needed 

Display may be retained below 

Number of millisec of cr delay needed 



from colxomn to last colxomn 
prototype if terminal settable 
display 
line 

line stays same 



like cm 
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dc 

dF 

dl 

dm 

dN 

do 

dT 

ed 

ei 

eo 

ff 

he 

hd 

ho 

hu 

hz 

ic 

if 

im 

in 

ip 

is 

k0-k9 

kb 

kd 

ke 

kh 

kl 

kn 

ko 

kr 

ks 

ku 

10- 

li 

11 

ma 

mi 

ml 

ms 

mu 

nc 

nd 

nl 

ns 

OS 

pc 
Pt 
se 
sf 
sg 
so 



19 



str 

num 

str 

str 

num 

str 

num 

str 

str 

str 

str 

bool 

str 

str 

str 

str 

str 

str 

bool 

bool 

str 

str 

str 

str 

str 

str 

str 

str 

num 

str 

str 

str 

str 

str 

num 

str 

str 

bool 

str 

bool 

str 

bool 

str 

str 

bool 

bool 

str 

bool 

str 

str 

num 

str 



nl delay needed 
tab delay needed 



(P*) Delete character 

Number of millisec of ff delay needed 
(P*) Delete line 

Delete mode (enter) 
Niamber of millisec of 
Down one line 
Number of millisec of 
End delete mode 

End insert mode; give ":ei=:" if ic 
Can erase overstrikes with a blank 
(P*) Hardcopy terminal page eject (default -^L) 
Hardcopy terminal 

Half-line down (forward 1/2 linefeed) 
Home cursor (if no cm) 
Half-line up (reverse 1/2 linefeed) 
Hazeltine; can't print ~'s 
(P) Insert character 

Name of file containing is 
Insert mode (enter); give ":im=:" if ic 
Insert mode distinguishes nulls on display 
(P*) Insert pad after character inserted 
Terminal initialization string 
Sent by "other" function keys 0-9 
Sent by backspace key 
Sent by terminal down arrow key 
Out of "keypad transmit" mode 
Sent by home key 
Sent by terminal left arrow key 
Number of "other" keys 

Termcap entries for other non-function keys 
Sent by terminal right arrow key 
Put terminal in "keypad transmit" mode 
Sent by terminal up arrow key 
Labels on "other" function keys 
Number of lines on screen or page 
Last line, first colxomn (if no cm) 
Arrow key map, used by vi version 2 only 
Safe to move while in insert mode 
Memory lock on above cursor. 

Ok to move while in standout & underline mode 
Memory unlock (turn off memory lock). 
No correct working carriage rtn (DM2500, H2000) 
Non-destructive space (cursor right) 
(P*) Newline character (default \n) 

Terminal is a CRT but doesn't scroll. 
Terminal overstrikes 
Pad character (rather than null) 
Has hardware tabs (may need to be set with is) 
End stand out mode 
(P) Scroll forwards 

Number of blank chars left by so or se 
Begin stand out mode 
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sr 


str (P) 


ta 


str (P) 


tc 


str 


te 


str 


ti 


str 


uc 


str 


ue 


str 


ug 


num 


ul 


bool 


up 


str 


us 


str 


vb 


str 


ve 


str 


vs 


str 


xb 


bool 


xn 


bool 


xr 


bool 


xs 


bool 


xt 


bool 



Scroll reverse (backwards) 

Tab (other than ^I or with padding) 

Entry of similar terminal - must be last 

String to end programs that use cm 

String to begin programs that use cm 

Underscore one char and move past it 

End underscore mode 

Number of blank chars left by us or ue 

Term, underlines even though doesn't overstrike 

Upline (cursor up) 

Start underscore mode 

Visible bell (may not move cursor) 

Sequence to end open/visual mode 

Sequence to start open/visual mode 

Beehive (fl=escape, f2=ctrl C) 

A newline is ignored after a wrap (Concept) 

Return acts like ce \r \n (Delta Data) 

Standout not erased by writing over it (HP 264?) 

Tabs destructive, magic so char (Teleray 1061) 



A Sample Entry 



The following entry, which describes the Concept-100, is 
among the more complex entries in the termcap file as of 
this writing. (This particular concept entry is outdated, 
and is used as an example only.) 

cl I clOO I conceptlOO : is=\EU\Ef \E7\E5\E8\El\ENH\EK\E\200\Eo&\200 :\ 
:al=3*\E'^R:am:bs:cd=16*\E'^C:ce=16\E'"S:cl=2*'^L:cm=\Ea%+ %+ :\ 
:co#80:\ 

:dc=16\E'^A:dl=3*\E^B:ei=\E\200:eo:im=\E'^P:in:ip=16*:\ 
:li#24:mi:nd=\E=:\ 
: se=\Ed\Ee : so=\ED\EE : ta=8\ t : ul : up=\E ; : vb=\Ek\EK: xn : 

Entries may continue onto multiple lines by giving a \ as 
the last character of a line, and that empty fields may be 
included for readability (here between the last field on a 
line and the first field on the next). Capabilities in 
termcap are of three types: Boolean capabilities which indi- 
cate that the terminal has some particular feature, numeric 
capabilities giving the size of the terminal or the size of 
particular delays, and string capabilities, which give a 
sequence which can be used to perform particular terminal 
operations. 

Types of Capabilities 

All capabilities have two letter codes. For instance, the 
fact that the Concept has "automatic margins" (i.e. an 
automatic return and linefeed when the end of a line is 
reached) is indicated by the capability am. Hence the 
description of the Concept includes am. Numeric 
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capabilities are followed by the character '#' and then the 
value. Thus co which indicates the number of columns the 
terminal has gives the value '80' for the Concept. 

Finally, string valued capabilities, such as ce (clear to 
end of line sequence) are given by the two character code, 
an '=', and then a string ending at the next following ':'. 
A delay in milliseconds may appear after the '=' in such a 
capability, and padding characters are supplied by the edi- 
tor after the remainder of the string is sent to provide 
this delay. The delay can be either a integer, e.g. '20', 
or an integer followed by an '*', i.e. '3*'. A '*' indi- 
cates that the padding required is proportional to the 
number of lines affected by the operation, and the amount 
given is the per-af fected-unit padding required. When a '*' 
is specified, it is sometimes useful to give a delay of the 
form '3.5' specify a delay per unit to tenths of mil- 
liseconds. 

A number of escape sequences are provided in the string 
valued capabilities for easy encoding of characters there. 
A \E maps to an ESCAPE character, '^x maps to a control-x for 
any appropriate x, and the sequences \n \r \t \b \f give a 
newline, return, tab, backspace and formfeed. Finally, 
characters may be given as three octal digits after a \, and 
the characters ^ and \ may be given as X'" and \\. If it is 
necessary to place a : in a capability it must be escaped in 
octal as \072. If it is necessary to place a null character 
in a string capability it must be encoded as \200. The rou- 
tines which deal with termcap use C strings, and strip the 
high bits of the output very late so that a \200 comes out 
as a \000 would. 

Preparing Descriptions 

We now outline how to prepare descriptions of terminals. 
The most effective way to prepare a terminal description is 
by imitating the description of a similar terminal in 
termcap and to build up a description gradually, using par- 
tial descriptions with ex to check that they are correct. 
Be aware that a very unusual terminal may expose deficien- 
cies in the ability of the termcap file to describe it or 
bugs in ex. To easily test a new terminal description you 
can set the environment variable TERMCAP to a pathname of a 
file containing the description you are working on and the 
editor will look there rather than in / etc / termcap . TERMCAP 
can also be set to the termcap entry itself to avoid reading 
the file when starting up the editor. (This only works on 
version 7 systems.) 
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Basic capabilities 

The number of columns on each line for the terminal is given 
by the co numeric capability. If the terminal is a CRT, 
then the number of lines on the screen is given by the li 
capability. If the terminal wraps around to the beginning 
of the next line when it reaches the right margin, then it 
should have the am capability. If the terminal can clear 
its screen, then this is given by the cl string capability. 
If the terminal can backspace, then it should have the bs 
capability, unless a backspace is accomplished by a charac- 
ter other than ^H (ugh) in which case you should give this 
character as the be string capability. If it overstrikes 
(rather than clearing a position when a character is struck 
over) then it should have the os capability. 

A very important point here is that the local cursor motions 
encoded in termcap are undefined at the left and top edges 
of a CRT terminal. The editor will never attempt to back- 
space around the left edge, nor will it attempt to go up 
locally off the top. The editor assumes that feeding off 
the bottom of the screen will cause the screen to scroll up, 
and the am capability tells whether the cursor sticks at the 
right edge of the screen. If the terminal has switch 
selectable automatic margins, the termcap file usually 
assumes that this is on, i.e. am. 

These capabilities suffice to describe hardcopy and "glass- 
tty" terminals. Thus the model 33 teletype is described as 

t3|33|tty33:co#72:os 
while the Lear Siegler ADM-3 is described as 

cl I adm3 I 3 I Isi adm3:am:bs:cl='^Z: li#24:co#80 

Cursor addressing 

Cursor addressing in the terminal is described by a cm 
string capability, with printf (3s) like escapes %x in it. 
These substitute to encodings of the current line or column 
position, while other characters are passed through 
unchanged. If the cm string is thought of as being a func- 
tion, then its arguments are the line and then the column to 
which motion is desired, and the % encodings have the fol- 
lowing meanings: 

%d as in printf , origin 

%2 like %2d 

%3 like %3d 

%. like %c 

%+x adds X to value, then %. 
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%>xy if value > x adds i 

%r reverses order of line 

%i increments line/column 

%% gives a single % 

%n exclusive or row and column with 0140 

%B BCD (16*(x/10)) + (x%10), no output. 

%D Rev coding (x-2*(x%16) ) , no output (Delta Data) 



no output. 

and column, no output 
(for 1 origin) 

(DM2500) 



Consider the HP2645, which, to get to 
needs to be sent \E&al2c03Y padded for 
that the order of the rows and columns 
that the row and column are printed as 
cm capability is "cm=6\E&%r%2c%2Y" . 
needs the current row and column sent 
the row and column simply encoded in 
Terminals which use "%." need to be 
cursor (bs or be), and to move the cur 
screen (up introduced below) . This i 
is not always safe to transmit \t, \n 
tem may change or discard them. 



row 3 and column 12, 

6 milliseconds. Note 

is inverted here, and 

two digits. Thus its 

The Microterm ACT- IV 

preceded by a -^T, with 

binary, "cm='^T%.%. " . 

able to backspace the 

sor up one line on the 

s necessary because it 

'^D and \r, as the sys- 



A final example is the LSI ADM-3a, which uses row and column 
offset by a blank character, thus "cm=\E=%+ %+ ". 

Cursor motions 

If the terminal can move the cursor one position to the 
right, leaving the character at the current position 
unchanged, then this sequence should be given as nd (non- 
destructive space). If it can move the cursor up a line on 
the screen in the same column, this should be given as up. 
If the terminal has no cursor addressing capability, but can 
home the cursor (to very upper left corner of screen) then 
this can be given as ho; similarly a fast way of getting to 
the lower left hand corner can be given as 11; this may 
involve going up with up from the home position, but the 
editor will never do this itself (unless 11 does) because it 
makes no assumption about the effect of moving up from the 
home position. 

Area clears 

If the terminal can clear from the current position to the 
end of the line, leaving the cursor where it is, this should 
be given as ce. If the terminal can clear from the current 
position to the end of the display, then this should be 
given as cd. The editor only uses cd from the first column 
of a line. 
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Insert/delete line 

If the terminal can open a new blank line before the line 
where the cursor is, this should be given as al; this is 
done only from the first position of a line. The cursor 
must then appear on the newly blank line. If the terminal 
can delete the line which the cursor is on, then this should 
be given as dl; this is done only from the first position on 
the line to be deleted. If the terminal can scroll the 
screen backwards, then this can be given as sb, but just al 
suffices. If the terminal can retain display memory above 
then the da capability should be given; if display memory 
can be retained below then db should be given. These let 
the editor understand that deleting a line on the screen may 
bring non-blank lines up from below or that scrolling back 
with sb may bring down non-blank lines. 

Insert/delete character 

There are two basic kinds of intelligent terminals with 
respect to insert/delete character which can be described 
using termcap . The most common insert/delete character 
operations affect only the characters on the current line 
and shift characters off the end of the line rigidly. Other 
terminals, such as the Concept 100 and the Perkin Elmer Owl, 
make a distinction between typed and untyped blanks on the 
screen, shifting upon an insert or delete only to an untyped 
blank on the screen which is either eliminated, or expanded 
to two untyped blanks. You can find out which kind of ter- 
minal you have by clearing the screen and then typing text 
separated by cursor motions. Type "abc def using local 
cursor motions (not spaces) between the "abc" and the "def. 
Then position the cursor before the "abc" and put the termi- 
nal in insert mode. If typing characters causes the rest of 
the line to shift rigidly and characters to fall off the 
end, then your terminal does not distinguish between blanks 
and untyped positions. If the "abc" shifts over to the 
"def" which then move together around the end of the current 
line and onto the next as you insert, you have the second 
type of terminal, and should give the capability in, which 
stands for "insert null". If your terminal does something 
different and unusual then you may have to modify the editor 
to get it to use the insert mode your terminal defines. We 
have seen no terminals which have an insert mode not not 
falling into one of these two classes. 

The editor can handle both terminals which have an insert 
mode, and terminals which send a simple sequence to open a 
blank position on the current line. Give as im the sequence 
to get into insert mode, or give it an empty value if your 
terminal uses a sequence to insert a blank position. Give 
as ei the sequence to leave insert mode (give this, with an 
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empty value also if you gave im so). Now give as ic any 
sequence needed to be sent just before sending the character 
to be inserted. Most terminals with a true insert mode will 
not give ic, terminals which send a sequence to open a 
screen position should give it here. (Insert mode is 
preferable to the sequence to open a position on the screen 
if your terminal has both.) If post insert padding is 
needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence which may need to be 
sent after an insert of a single character may also be given 
in ip. 

It is occasionally necessary to move around while in insert 
mode to delete characters on the same line (e.g. if there is 
a tab after the insertion position). If your terminal 
allows motion while in insert mode you can give the capabil- 
ity mi to speed up inserting in this case. Omitting mi will 
affect only speed. Some terminals (notably Datamedia's) 
must not have mi because of the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to 
enter and exit delete mode, and dc to delete a single char- 
acter while in delete mode. 

Highlighting, underlining, and visible bells 

If your terminal has sequences to enter and exit standout 
mode these can be given as so and se respectively. If there 
are several flavors of standout mode (such as inverse video, 
blinking, or underlining - half bright is not usually an 
acceptable "standout" mode unless the terminal is in inverse 
video mode constantly) the preferred mode is inverse video 
by itself. If the code to change into or out of standout 
mode leaves one or even two blank spaces on the screen, as 
the TVI 912 and Teleray 1061 do, then ug should be given to 
tell how many spaces are left. 

Codes to begin underlining and end underlining can be given 
as us and ue respectively. If the terminal has a code to 
underline the current character and move the cursor one 
space to the right, such as the Microterm Mime, this can be 
given as uc. (If the underline code does not move the cur- 
sor to the right, give the code followed by a nondestructive 
space. ) 

Many terminals, such as the HP 2621, automatically leave 
standout mode when they move to a new line or the cursor is 
addressed. Programs using standout mode should exit stan- 
dout mode before moving the cursor or sending a newline. 

If the terminal has a way of flashing the screen to indicate 
an error quietly (a bell replacement) then this can be given 
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as vb; it must not move the cursor. If the terminal should 
be placed in a different mode during open and visual modes 
of ex, this can be given as vs and ve, sent at the start and 
end of these modes respectively. These can be used to 
change, e.g., from a underline to a block cursor and back. 

If the terminal needs to be in a special mode when running a 
program that addresses the cursor, the codes to enter and 
exit this mode can be given as ti and te. This arises, for 
example, from terminals like the Concept with more than one 
page of memory. If the terminal has only memory relative 
cursor addressing and not screen relative cursor addressing, 
a one screen-sized window must be fixed into the terminal 
for cursor addressing to work properly. 

If your terminal correctly generates underlined characters 
(with no special codes needed) even though it does not over- 
strike, then you should give the capability ul. If over- 
strikes are erasable with a blank, then this should be indi- 
cated by giving eo. 

Keypad 

If the terminal has a keypad that transmits codes when the 
keys are pressed, this information can be given. Note that 
it is not possible to handle terminals where the keypad only 
works in local (this applies, for example, to the unshifted 
HP 2621 keys). If the keypad can be set to transmit or not 
transmit, give these codes as ks and ke. Otherwise the 
keypad is assumed to always transmit. The codes sent by the 
left arrow, right arrow, up arrow, down arrow, and home keys 
can be given as kl, kr, ku, kd, and kh respectively. If 
there are function keys such as fO, fl, ..., f9, the codes 
they send can be given as kO, kl, ..., k9. If these keys 
have labels other than the default fO through f9, the labels 
can be given as 10, 11, ..., 19. If there are other keys 
that transmit the same code as the terminal expects for the 
corresponding function, such as clear screen, the termcap 2 
letter codes can be given in the ko capability, for example, 
":ko=cl,ll,sf ,sb: " , which says that the terminal has clear, 
home down, scroll down, and scroll up keys that transmit the 
same thing as the cl, 11, sf, and sb entries. 

The ma entry is also used to indicate arrow keys on termi- 
nals which have single character arrow keys. It is obsolete 
but still in use in version 2 of vi, which must be run on 
some minicomputers due to memory limitations. This field is 
redundant with kl, kr, ku, kd, and kh. It consists of 
groups of two characters. In each group, the first charac- 
ter is what an arrow key sends, the second character is the 
corresponding vi command. These commands are h for kl, j 
for kd, k for ku, 1 for kr, and H for kh. For example, the 
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mime would be :ma='^Kj'^Zk'^Xl: indicating arrow keys left 
(-^H), down (^K), up C'Z), and right (^X). (There is no home 
key on the mime. ) 

Miscellaneous 

If the terminal requires other than a null (zero) character 
as a pad, then this can be given as pc. 

If tabs on the terminal require padding, or if the terminal 
uses a character other than -^I to tab, then this can be 
given as ta. 

Hazeltine terminals, which don't allow '~' characters to be 
printed should indicate hz. Datamedia terminals, which echo 
carriage-return linefeed for carriage return and then ignore 
a following linefeed should indicate nc. Early Concept ter- 
minals, which ignore a linefeed immediately after an am 
wrap, should indicate xn. If an erase-eol is required to 
get rid of standout (instead of merely writing on top of 
it), xs should be given. Teleray terminals, where tabs turn 
all characters moved over to blanks, should indicate xt. 
Other specific terminal problems may be corrected by adding 
more capabilities of the form xx. 

Other capabilities include is, an initialization string for 
the terminal, and if, the name of a file containing long 
initialization strings. These strings are expected to prop- 
erly clear and then set the tabs on the terminal, if the 
terminal has settable tabs. If both are given, is will be 
printed before if. This is useful where if is 
/ usr / 1 ib / tabset / std but is clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined 
as being just like the other with certain exceptions. The 
string capability tc can be given with the name of the simi- 
lar terminal. This capability must be last and the combined 
length of the two entries must not exceed 1024. Since term- 
lib routines search the entry from left to right, and since 
the tc capability is replaced by the corresponding entry, 
the capabilities given at the left override the ones in the 
similar terminal. A capability can be canceled with xx@ 
where xx is the capability. For example, the entry 

hn|2621nl:ks(a:ke@:tc=2621: 

defines a 2621nl that does not have the ks or ke capabili- 
ties, and hence does not turn on the function key labels 
when in visual mode. This is useful for different modes for 
a terminal, or for different user preferences. 
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FILES 

/etc/termcap file containing terminal descriptions 

SEE ALSO 

ex(l), cursesO), termcapO), tset(l), vi(l), ul{l), more(l) 

AUTHOR 

William Joy 

Mark Horton added underlining and keypad support 

RESTRICTIONS 

Ex allows only 256 characters for string capabilities, and 
the routines in termcap Q) do not check for overflow of this 
buffer. The total length of a single entry (excluding only 
escaped newlines) may not exceed 1024. 

The ma, vs, and ve entries are specific to the vi program. 

Not all programs support all entries. There are entries 
that are not supported by any program. 
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NAME 

tp - DEC/mag tape formats 

DESCRIPTION 

The command tg dumps files to and extracts files from DEC- 
tape and magtape. The formats of these tapes are the same 
except that magtapes have larger directories. 

Block zero contains a copy of a stand-alone bootstrap pro- 
gram. 

Blocks 1 through 24 for DECtape (1 through 62 for magtape) 
contain a directory of the tape. There are 192 (resp. 496) 
entries in the directory; 8 entries per block; 64 bytes per 
entry. Each entry has the following format: 

struct { 

char pathname[32] ; 

int mode; 

char uid; 

char gid; 

char unusedl; 

char size[3]; 

long modtime; 

int tapeaddr; 

char unused2[16]; 

int checksum; 
}; 

The path name entry is the path name of the file when put on 
the tape. If the pathname starts with a zero word, the 
entry is empty. It is at most 32 bytes long and ends in a 
null byte. Mode, uid, gid, size and time modified are the 
same as described under i-nodes (see file system f ilsys (5) ) . 
The tape address is the tape block number of the start of 
the contents of the file. Every file starts on a block 
boundary. The file occupies (size+511)/512 blocks of con- 
tinuous tape. The checksum entry has a value such that the 
sum of the 32 words of the directory entry is zero. 

Blocks above 25 (resp. 63) are available for file storage. 

A fake entry has a size of zero. 

SEE ALSO 

filsys(5), tp(l) 

RESTRICTIONS 

The pathname , uid , gid , and size fields are too small. 
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NAME 

ttys - terminal initialization data 

DESCRIPTION 

The ttys file is read by the init program and specifies 
which terminal special files are to have a process created 
for them which will allow people to log in. It contains one 
line per special file. 

The first character of a line is either '0', '1', '2' or 
'3'; zero causes the line to be ignored, one causes it to be 
effective as a dialup line, two specifies local terminal 
operation, and three specifies local terminal operation, but 
does not run logins on that line. 

The second character is used as an argument to getty (8) , 
which performs such tasks as baud-rate recognition, reading 
the login name, and calling login . Refer to getty (8) for a 
list of these special characters and their meanings. 

The remainder of the line is the terminal's entry in the 
device directory, /dev. 

FILES 

/etc/ttys 

SEE ALSO 

init(8), getty(8), login(l) 

ULTRIX-11 System Management Guide, Section 4.7 
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NAME 

ttytype - terminal type data 

SYNOPSIS 

/etc/ttytype 

DESCRIPTION 

The ttytype file is read by the login program and specifies 
a terminal type name and the line name. It contains one 
line per terminal port. 

The first entry is a terminal type name, then a space, and 
then the name of the tty line, minus /dev/. 

Terminal types are of the order - vtlOO, vtlOOw, vt52, la36, 
dialup, lal20, etc. 

SEE ALSO 

login(l) 
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TYPES ( 5 ) 



NAME 



types - primitive system data types 



SYNOPSIS 

# include <sys/types.h> 

DESCRIPTION 

The data types defined in the include file are used in UNIX 
system code; some data of these types are accessible to user 
code: 



/* 

* SCCSID: @(#)types.h 

*/ 

fifndef TYPES 

fdefine TYPES 

typedef long 

typedef char * 

typedef unsigned int 

typedef long 

typedef int 

typedef int 

typedef long 



typedef 
typedef 



typedef 
typedef 
typedef 
typedef 
typedef 
typedef 



/* 
#def ine 
#def ine 
#def ine 
#endif 



1.2 8/13/84 



daddr_t ; 
caddr_t; 
ino_t; 
t ime_t ; 
label_t[7]; 
dev_t ; 
off t; 



/* 
/* 
/* 
/* 
/* 
/* 



disk address */ 
core address */ 
i-node number */ 
a time */ 
program status */ 
device code */ 



/* offset in file */ 



char bool_t; 
unsigned short comp t; 



unsigned memaddr; /* 
struct {short r[l];}* 
unsigned size_t; 
long ubadr_t; /* 
unsigned short u_short; 
short void; 



/* Boolean */ 

/* "floating tp" : 

3 bits base 8 exp, 
13 bits fraction */ 
core or swap address */ 
physadr; 

/* size of process segments */ 
UNIBUS address */ 

/* So Ritchie C compiler 
won't die */ 



selectors and constructor for device code 
major(x) ( int) ( ( (unsigned)x»8) ) 
minor(x) ( int) (xSc0377) 
makedev(x,y) (dev_t) ( (x)«8 I (y) ) 



V 



The form daddr t is used for disk addresses except in an i- 
node on disk, see f ilsys (5). Times are encoded in seconds 
since 00:00:00 GMT, January 1, 1970. The major and minor 
parts of a device code specify kind and unit number of a 
device and are installation-dependent. Offsets are measured 
in bytes from the beginning of a file. The label t vari- 
ables are used to save the processor state while another 
process is running. 
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SEE ALSO 

filsys(5), time(2), lseek(2), adb(l) 



UTMP(5) UTMP(5) 



NAME 

utmp, wtmp - login records 

SYNOPSIS 

#in(t:lude <utmp.h> 

DESCRIPTION 

The utmp file allows one to discover information about who 
is currently using UNIX. The file is a sequence of entries 
with the following structure declared in the include file: 

/* 

* SCCSID: @(#)utmp.h 1.0 11/12/83 

*/ 
struct utmp { 

char ut_line[8]; /* tty name */ 



}; 



char ut_name[8]; /* user id */ 
long ut_time; /* time on */ 



This structure gives the name of the special file associated 
with the user's terminal, the user's login name, and the 
time of the login in the form of t ime ( 2 ) . 

The wtmp file records all logins and logouts. Its format is 
exactly like utmp except that a null user name indicates a 
logout on the associated terminal. Furthermore, the termi- 
nal name '-' indicates that the system was rebooted at the 
indicated time; the adjacent pair of entries with terminal 
names 'I' and '}' indicate the system-maintained time just 
before and just after a date command has changed the 
system's idea of the time. 

Wtmp is maintained by login (l) and init (8). Neither of 
these programs creates the file, so if it is removed 
record-keeping is turned off. It is summarized by ac(l). 

FILES 

/etc/utmp 
/usr/adm/wtmp 

SEE ALSO 

login(l), init(8), who(l), ac(l) 
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NAME 

arithmetic - provide drill in number facts 

SYNOPSIS 

/usr/games/arithmetic [ +-x/ ] [ range ] 

DESCRIPTION 

Arithmetic types out simple arithmetic problems, and waits 
for an answer to be typed in. If the answer is correct, it 
types back "Right!", and a new problem. If the answer is 
wrong, it replies "What?", and waits for another answer. 
Every twenty problems, it publishes statistics on correct- 
ness and the time required to answer. 

To quit the program, type an interrupt (delete). 

The first optional argument determines the kind of problem 
to be generated; +-x/ respectively cause addition, subtrac- 
tion, multiplication, and division problems to be generated. 
One or more characters can be given; if more than one is 
given, the different types of problems will be mixed in ran- 
dom order; default is +- 

Range is a decimal number; all addends, subtrahends, differ- 
ences, multiplicands, divisors, and quotients will be less 
than or equal to the value of range . Default range is 10. 

At the start, all numbers less than or equal to range are 
equally likely to appear. If the respondent makes a mis- 
take, the numbers in the problem which was missed become 
more likely to reappear. 

As a matter of educational philosophy, the program will not 
give correct answers, since the learner should, in princi- 
ple, be able to calculate them. Thus the program is 
intended to provide drill for someone just past the first 
learning stage, not to teach number facts de novo . For 
almost all users, the relevant statistic should be time per 
problem, not percent correct. 
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NAME 

backganunon - the game 

SYNOPSIS 

/usr/games/backgammon 

DESCRIPTION 

This program does what you expect. It will ask whether you 
need instructions. 
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NAME 

banner - make long posters 

SYNOPSIS 

/usr/games/banner 

DESCRIPTION 

Banner reads the standard input and prints it sideways in 
huge built-up letters on the standard output. 
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NAME 

bed, ppt - convert to antique media 

SYNOPSIS 

/usr/games/bcd text 

/usr/games/ppt 

DESCRIPTION 

Bed converts the literal text into a form familiar to old- 
timers. 

Ppt converts the standard input into yet another form. 

SEE ALSO 
ddd) 
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NAME 

bj - the game of black jack 

SYNOPSIS 

/usr/games/bj 

DESCRIPTION 

52 is a serious attempt at simulating the dealer in the game 
of black jack (or twenty-one) as might be found in Reno. 
The following rules apply: 

The bet is $2 every hand. 

A player 'natural' (black jack) pays $3. A dealer 
natural loses $2. Both dealer and player naturals is a 
'push' (no money exchange). 

If the dealer has an ace up, the player is allowed to 
make an 'insurance' bet against the chance of a dealer 
natural. If this bet is not taken, play resximes as 
normal. If the bet is taken, it is a side bet where 
the player wins $2 if the dealer has a natural and 
loses $1 if the dealer does not. 

If the player is dealt two cards of the same value, he 
is allowed to 'double'. He is allowed to play two 
hands, each with one of these cards. (The bet is dou- 
bled also; $2 on each hand.) 

If a dealt hand has a total of ten or eleven, the 
player may 'double down'. He may double the bet ($2 to 
$4) and receive exactly one more card on that hand. 

Under normal play, the player may 'hit' (draw a card) 
as long as his total is not over twenty-one. If the 
player 'busts' (goes over twenty-one), the dealer wins 
the bet. 

When the player 'stands' (decides not to hit), the 
dealer hits until he attains a total of seventeen or 
more. If the dealer busts, the player wins the bet. 

If both player and dealer stand, the one with the larg- 
est total wins. A tie is a push. 

The machine deals and keeps score. The following questions 
will be asked at appropriate times. Each question is 
answered by y followed by a new line for 'yes', or just new 
line for 'no' . 

? (means, 'do you want a hit?') 
Insurance? 
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Double down? 

Every time the deck is shuffled, the dealer so states and 
the 'action' (total bet) and 'standing' (total won or lost) 
is printed. To exit, hit the interrupt key (DEL) and the 
action and standing will be printed. 
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NAME 



checkers - game 



SYNOPSIS 

/usr /games/checkers 

DESCRIPTION 

Checkers uses standard notation for the board: 

BLACK 



1 //// 
1 //// 


1 


//// 
//// 


2 


//// 
//// 


3 


//// 
//// 


4! 


1 5 


//// 
//// 

i 


6 


//// 
//// 


7 


//// 


8 


////I 
////i 


1 ////I 
! //// 


9 


//// 


10 


//// 


11 


//// 
//// 


121 


1 13 


//// 


14 


III/ 
//// 


15 


//// 
//// 


16 


////I 


1 //// 
1 //// 


17 


//// 
//// 


18 


//// 
//// 


19 


//// 


201 


1 21 


//// 
//// 


22 


//// 
//// 


23 


//// 
//// 


24 


////I 


i //// 
1 //// 


25 


, //// 
//// 


26 


, //// 
//// 


27 


i //// 
1 //// 


28 1 


i 29 


1 //// 
//// 


30 


! //// 
//// 


31 


nn 
//// 


32 


iin\ 
////I 



WHITE 

Black plays first. The program normally plays white. To 
specify a move, name the square moved from and the square 
moved to. For multiple jumps name all the squares touched. 

Certain commands may be given instead of moves: 

reverse Reverse roles; the program takes over your pieces. 

backup Undo the last move for each player. 

list Print the record of the game. 

move Let the program select a move for you. 

print Print a map of the present position. 
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NAME 

chess - the game of chess 

SYNOPSIS 

/usr/games/chess 

DESCRIPTION 

Chess is a computer program that plays class D chess. Moves 
may be given either in standard (descriptive) notation or in 
algebraic notation. The symbol '+' is used to specify 
check; 'o-o' and 'o-o-o' specify castling. To play black, 
type 'first'; to print the board, type an empty line. 

Each move is echoed in the appropriate notation followed by 
the program's reply. 

FILES 

/usr/lib/book opening 'book' 

DIAGNOSTICS 

The most cryptic diagnostic is 'eh?' which means that the 
input was syntactically incorrect. 

WARNING 

Over-use of this program will cause it to go away. 

RESTRICTIONS 

Pawns may be promoted only to queens. 
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NAME 

ching, fortune - the book of changes and other cookies 

SYNOPSIS 

/usr/games/ching [ hexagram ] 

/usr/games/fortune 

DESCRIPTION 

The I^ Ching or Book of Changes is an ancient Chinese oracle 
that has been in use for centuries as a source of wisdom and 
advice. 

The text of the oracle (as it is sometimes known) consists 
of sixty-four hexagrams , each symbolized by a particular 

arrangement of six straight ( ) and broken (- -) lines. 

These lines have values ranging from six through nine, with 
the even values indicating the broken lines. 

Each hexagram consists of two major sections. The Judgement 
relates specifically to the matter at hand (E.g., "It furth- 
ers one to have somewhere to go.") while the Image describes 
the general attributes of the hexagram and how they apply to 
one's own life ("Thus the superior man makes himself strong 
and untiring.") . 

When any of the lines have the values six or nine, they are 
moving lines; for each there is an appended judgement which 
becomes significant. Furthermore, the moving lines are 
inherently unstable and change into their opposites; a 
second hexagram (and thus an additional judgement) is 
formed . 

Normally, one consults the oracle by fixing the desired 
question firmly in mind and then casting a set of changes 
(lines) using yarrow-stalks or tossed coins. The resulting 
hexagram will be the answer to the question. 

Using an algorithm suggested by S. C. Johnson, the Unix ora- 
cle simply reads a question from the standard input (up to 
an EOF) and hashes the individual characters in combination 
with the time of day, process id and any other magic numbers 
which happen to be lying around the system. The resulting 
value is used as the seed of a random number generator which 
drives a simulated coin-toss divination. The answer is then 
piped through nroff for formatting and will appear on the 
standard output. 

For those who wish to remain steadfast in the old tradi- 
tions, the oracle will also accept the results of a personal 
divination using, for example, coins. To do this, cast the 
change and then type the resulting line values as an 
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argument. 

The impatient modern may prefer to settle for Chinese cook- 
ies; try fortune . 

SEE ALSO 

It furthers one to see the great man. 

DIAGNOSTICS 

The great prince issues commands. 

Founds states, vests families with fiefs. 

Inferior people should not be employed. 

RESTRICTIONS 

Waiting in the mud 

Brings about the arrival of the enemy. 

If one is not extremely careful, 

Somebody may come up from behind and strike him. 

Misfortune. 
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NAME 

ttt, cubic - tic-tac-toe 

SYNOPSIS 

/usr/games/ttt 

/usr/games/cubic 

DESCRIPTION 

Ttt is the X and game popular in the first grade. This is 
a learning program that never makes the same mistake twice. 

Although it learns, it learns slowly. It must lose nearly 
80 games to completely know the game. 

Cubic plays three-dimensional tic-tac-toe on a 4x4x4 board. 
Moves are specified as a sequence of three coordinate 
numbers in the range 1-4. 

FILES 

/usr/games/ttt.k learning file 
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NAME 

maze - generate a maze problem 

SYNOPSIS 

/usr/games/maze/ 

DESCRIPTION 

Maze asks a few questions and then prints a maze. 

RESTRICTIONS 

Some mazes (especially small ones) have no solutions. 
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NAME 

moo - guessing game 

SYNOPSIS 

/usr/games/moo 

DESCRIPTION 

Moo is a guessing game imported from England. The computer 
picks a number consisting of four distinct decimal digits. 
The player guesses four distinct digits being scored on each 
guess. A 'cow' is a correct digit in an incorrect position. 
A 'bull' is a correct digit in a correct position. The game 
continues until the player guesses the nximber (a score of 
four bulls) . 
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NAME 

quiz - test your knowledge 

SYNOPSIS 

/usr/games/quiz [ -i file ] [ -t ] [ categoryl category2 ] 

DESCRIPTION 

Quiz gives associative knowledge tests on various subjects. 
It asks items chosen from categoryl and expects answers from 
cateqory2 . If no categories are specified, quiz gives 
instructions and lists the available categories. 

Quiz tells a correct answer whenever you type a bare new- 
Tine. At the end of input, upon interrupt, or when ques- 
tions run out, quiz reports a score and terminates. 

The -t flag specifies 'tutorial' mode, where missed ques- 
tions are repeated later, and material is gradually intro- 
duced as you learn. 

The -i flag causes the named file to be substituted for the 
default index file. The lines of these files have the syn- 
tax: 



line = category newline I category ':' line 

category = alternate I category ' I ' alternate 

alternate = empty I alternate primary 

primary = character I '[' category ']' I option 

option = '{' category '}' 



f 



The first category on each line of an index file names an 
information file. The remaining categories specify the 
order and contents of the data in each line of the informa- 
tion file. Information files have the same syntax. 
Backslash '\' is used as with sh(l) to quote syntactically 
significant characters or to insert transparent newlines 
into a line. When either a question or its answer is empty, 
quiz will refrain from asking it. 

FILES 

/usr/games/quiz.k/* 

RESTRICTIONS 

The construct 'alab' doesn't work in an information file. 
Use 'a{b}'. 
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NAME 

reversi - a game of dramatic reversals 

SYNOPSIS 

/usr/games/reversi [ [ -r ] file ] 

DESCRIPTION 

Reversi (also known as 'friends', 'Chinese friends' and 
'Othello' ) is played on an 8x8 board using two-sided tokens. 
Each player takes his turn by placing a token with his side 
up in an empty square. During the first four turns, players 
may only place tokens in the four central squares of the 
board. Subsequently, with each turn, a player must capture 
one or more of his opponent's tokens. He does this by plac- 
ing one of his tokens such that it and another of his tokens 
embrace a solid line of his opponent's horizontally, verti- 
cally or diagonally. Captured tokens are flipped over and 
thus can be re-captured. If a player cannot outflank his 
opponent he forfeits his turn. The play continues until the 
board is filled or until no more outflanking is possible. 

In this game, your tokens are asterisks and the machine's 
are at-signs. You move by typing in the row and column at 
which you want to place your token as two digits (1-8), 
optionally separated by blanks or tabs. You can also type 

c to continue the game after hitting break (this is only 
necessary if you interrupt the machine while it is 
deliberating) . 

g n to start reversi playing against itself for the next n 
moves (or until the break key is hit). 

n to stop printing the board after each move. 

o to start it up again. 

p to print the board regardless. 

q to quit (without dishonor). 

s to print the score. 

Reversi also recognizes several commands which are valid 
only at the start of the game, before any moves have been 
made. They are 

f to let the machine go first. 

h n to ask for a handicap of from one to four corner 
squares. If you're good, you can give the machine a 
handicap by typing a negative number. 
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1 n to set the amount of lookahead used by the machine in 
searching for moves. Zero means none at all. Four is 
the default. Greater than six means you may fall 
asleep waiting for the machine to move. 

t n to tell reversi that you will only need n seconds to 
consider each move. If you fail to respond in the 
allotted time, you forfeit your turn. 

If reversi is given a file name as an argument, it will 
checkpoint the game, move by move, by dumping the board onto 
file. The -r option will cause reversi to restart the game 
from file and continue logging. 
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NAME 

ttt, cubic - tic-tac-toe 

SYNOPSIS 

/usr/games/ttt 

/usr/games/cubic 

DESCRIPTION 

Ttt is the X and game popular in the first grade. This is 
a learning program that never makes the same mistake twice. 

Although it learns, it learns slowly. It must lose nearly 
80 games to completely know the game. 

Cubic plays three-dimensional tic-tac-toe on a 4x4x4 board. 
Moves are specified as a sequence of three coordinate 
numbers in the range 1-4. 

FILES 

/usr/games/ttt. k learning file 
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NAME 

hangman, words - word games 

SYNOPSIS 

/usr/games/hangman [ diet ] 

/usr/games/words 

DESCRIPTION 

Hangman chooses a word at least seven letters long from a 
word list. The user is to guess letters one at a time. 

The optional argument names an alternate word list. The 
special name '-a' gets a particular very large word list. 

Words prints all the uncapitalized words in the word list 
that can be made from letters in string . 

FILES 

/us r/dict /words the regular word list 
/crp/dict/web2 the the -a word list 

DIAGNOSTICS 

After each round, hangman reports the average number of 
guesses per round and the number of rounds. 

RESTRICTIONS 

Hyphenated compounds are run together. 

UNIX software is distributed without the -a word list. 
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NAME 

wxjmp - the game of hunt-the-wumpus 

SYNOPSIS 

/usr/garaes/wiimp 

DESCRIPTION 

Wuunp plays the game of 'Hunt the Wumpus.' A Wumpus is a 
creature that lives in a cave with several rooms connected 
by tunnels. You wander among the rooms, trying to shoot the 
Wumpus with an arrow, meanwhile avoiding being eaten by the 
Wumpus and falling into Bottomless Pits. There are also 
Super Bats which are likely to pick you up and drop you in 
some random room. 

The program asks various questions which you answer one per 
line; it will give a more detailed description if you want. 

This program is based on one described in People 's Computer 
Company , 2, 2 (November 1973). 

RESTRICTIONS 

It will never replace Space War. 
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NAME 



ascii - map of ASCII character set 



SYNOPSIS 
































cat /usr/pub/ 


ascii 
























DESCRIPTION 






























Ascii 


is 


a map of 


■ the 


ASCII c 


haracter 


set 


., to 


be 


printed 


as 




needed . 


It contains: 
























1000 


nul 


001 


sohl 


002 


stx 


003 


etx 


004 


eot 


005 


enq 


006 


ack 


007 


bell 


1 010 


bs 1 


Oil 


ht 


012 


nl 


013 


vt 


014 


np 


015 


cr 


016 


so 


017 


si 1 


1020 


die 


021 


del 


022 


dc2 


023 


dc3 


024 


dc4 


025 


nak 


026 


syn 


027 


etbl 


1030 


can 


031 


em 


032 


sub 


033 


esc 


034 


fs 


035 


gs 


036 


rs 


037 


us 1 


1040 


sp 


041 


1 


042 


n 


043 


# 


044 


$ 


045 


% 


046 


£> 


047 


• 1 


1050 


( 


051 


) 


052 


* 


053 


+ 


054 


1 


055 


- 


056 


• 


057 


/ 1 


1060 





061 


1 


062 


2 


063 


3 


064 


4 


065 


5 


066 


6 


067 


7 1 


1070 


8 


071 


9 


072 


• 
• 


073 


• 
f 


074 


< 


075 


= 


076 


> 


077 


? 1 


lioo 


@ 


101 


A 


102 


B 


103 


C 


104 


D 


105 


E 


106 


F 


107 


G 1 


1110 


H 


111 


I 


112 


J 


113 


K 


114 


L 


115 


M 


116 


N 


117 


1 


1120 


P 


121 


Q 


122 


R 


123 


S 


124 


T 


125 


U 


126 


V 


127 


W 1 


1130 


X 


131 


Y 


132 


Z 


133 


[ 


134 


\ 


135 


] 


136 


^ 


137 


1 


1140 


^ 


141 


a 


142 


b 


143 


c 


144 


d 


145 


e 


1146 


f 


1147 


g 1 


1150 


h 


1151 


i 


1152 


j 


153 


k 


154 


1 


1155 


m 


1156 


n 


1157 


o 1 


1160 


P 


1161 


q 


1162 


r 


1163 


s 


1164 


t 


1165 


u 


1166 


V 


1167 


w 1 


1170 


X 


1171 


y 


1172 


z 


1173 


{ 


1174 


1 


1175 


} 


1176 


~ 


1177 


dell 



FILES 



/usr/pub/ascii 
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NAME 

eqnchar — special character definitions for eqn 

SYNOPSIS 

eqn /usr/pub/eqnchar [ files ] | troff [ options ] 

neqn /usr/pub/eqnchar [ files ] | nroif [ options ] 

DESCRIPTION 

Eqnchar contains troff and nroff character definitions for constructing characters that are not 
available on the Graphic Systems typesetter. These definitions are primarily intended for use 
with eqn and neqn. It contains definitions for the following characters 

ciplus ® II II 



citimes 


€) 


langle 


1 
\ 


wig 


— 


rangle 


] 


'Wig 


= 


hbar 


71 


>wig 


^ 


ppd 


1 


<wig 


<. 


<-> 


— 


—wig 


s 


<-> 


■♦■ 


star 


* 




< 


bigstar 


* 


> 


> 


—dot 


- 


ang 


L 


orsign 


V 


rang 


L 


andsign 


A 


3dot 


\ 


-del 


^ 


thf 


, , 


oppA 


V 


quarter 


>/4 


oppE 


^ 


Squarter 


V* 


angstrom 


A 


degree 





FILES 








/usr/pub/eqnchar 






SEE ALSO 








troff(l). 


eqn(l) 







square 


D 


circle 





bht 


■ 


bullet 


• 


prop 


s 


empty 





member 


€ 


nomem 


i 


cup 


u 


cap 


n 


inct 


c 


subset 


c 


supset 


D 


Isubset 


£ 


fsupset 


2 
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NAME 

greek - graphics for extended TTY-37 type-box 

SYNOPSIS 

cat /usr/pub/greek [ | greek — Tterminal ] 

DESCRIPTION 

Greek gives tiie mapping from ascii to the 'shift out' graphics in effect between SO and SI on 
model 37 Teletypes with a 128-character type-box. These are the default greek characters pro- 
duced by nroff. The filters of greekiX) attempt to print them on various other terminals. The 
file contains: 



alpha 
GAMMA 


a 

r 


A 
G 


epsilon 
THETA 


6 




s 

T 


LAMBDA 


A 


E 


xi 


f 


X 


rho 


P 


K 


tau 


T 


I 


psi 
OMEGA 




n 


V 

z 


partial 


d 


1 


SEE ALSO 

greek(l) 
troffd) 







beta 


^ 


B 


delta 


8 


D 


zeta 


C 


Q 


theta 


ti 





mu 


M 


M 


pi 


TT 


J 


Sigma 


cr 


Y 


phi 





U 


PSI 


* 


H 
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V 


[ 
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y 
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DELTA 


^ 


W 
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V 


N 
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k 


L 


nu 


V 


@ 


PI 


n 


P 


SIGMA 


I 


R 


PHI 


•D 


F 


omega 


a> 


C 


not 


-> 
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NAME 

hier - file system hierarchy 

DESCRIPTION 

The following outline gives a quick tour through a represen- 
tative directory hierarchy. 

/ root 
/dev/ 

devices (4) 

console 

main console, tty(4) 

tty* terminals, tty (4) 

cat phototypesetter cat (4) 

rp* disks, rg, hp(4) 

rrp* raw disks, r^, h£(4) 

/bin/*** 

utility programs, cf /usr/bin/ (1) 

as assembler first pass, cf /usr/lib/as2 

cc C compiler executive, cf /usr/lib/c[012] 

• • • 

/lib/ 

object libraries and other stuff, cf /usr/lib/ 
libc.a 

system calls, standard I/O, etc. (2,3,3S) 
libm.a 

math routines (3M) 
libplot.a 

plotting routines, plot (3) 
libF77.a 

Fortran runtime support 
libI77.a 

Fortran I/O 

• • • 

as2 second pass of as(l) 
c[012] 

passes of cc(l) 

• • • 

/etc/ 

essential data and dangerous maintenance utilities 
passwd 

password file, passwd (5) 
group 

group file, group (5) 
motd message of the day, login (l) 
mtab mounted file table, mtab (5) 
ddate 

dump history, dump ( 1 ) 
ttys properties of terminals, ttys (5) 
getty 

part of login , getty (8) 
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init the father of all processes, init (8) 
re shell program to bring the system up 
cron the clock daemon, cron (8) 
mount 

mount ( 1 ) 
wall vall (l) 

• • • 

/tmp/ 

temporary files, usually on a fast device, cf /usr/tmp/ 
e* used by ed(l) 
ctm* used by cc(l) 

• • « 

/usr/ 

general-pupose directory, usually a mounted file system 
adm/ administrative information 
wtmp login history, utmp ( 5 ) 
messages 

hardware error messages 
tracct 

phototypesetter accounting, troff(l) 
vpacct 

line printer accounting Ipr (l) 
/usr /bin 

utility programs, to keep /bin/ small 
tmp/ temporaries, to keep /tmp/ small 
stm* used by sort (l) 
raster 

used by plot (l) 
diet/ 

word lists, etc. 
words 

principal word list, used by look(l) 
spellhist 

history file for spell (l) 
games/ 

bj blackjack 

hangman 

quiz.k/ 

what quiz (6) knows 
index 

category index 
africa 

countries and capitals 



include/ 

standard # include files 
a . out . h 

object file layout, a. out (5) 
stdio.h 

standard I/O, stdio O) 
math.h 



"^^^^^^ HIER(7) 



(3M) 

• • • 

sys/ system-defined layouts, cf /usr/sys/h 
acct.h 

process accounts, acct(5) 

buf.h 

internal system buffers 

• • • 

lib/ object libraries and stuff, to keep /lib/ small 
lint[12] 

subprocesses for lint(l) 
llib-lc 

dummy declarations for /lib/libc.a, used by 
lint (l) ' 

llib-IHT" 

dummy declarations for /lib/libc.m 
atrun 

scheduler for at(l) 
struct/ 

passes of struct (1) 

• • • 

tmac/ 

macros for troff(l) 
tmac . an 

macros for man (7) 
tmac . s 

macros for ms(7) 

font/ 

fonts for troff(l) 
R Times Roman 
B Times Bold 

• • • 

uucp/ 

programs and data for uucp (l) 
L.sys 

remote system names and numbers 
uucico 

the real copy program 

• • • 

suftab 

table of suffixes for hyphenation, used by 
troff(l) ^ 

units 

conversion tables for units(l) 

eign list of English words to be ignored by otxd) 
/usr/ man/ ^ — 

volume 1 of this manual, man(l) 

manO/ 

general 

intro 

introduction to volume 1, ms(7) format 
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XX template for manual page 
manl/ 

chapter 1 
as.l 
mount . Im 

• • • 

catl/ 

preprinted pages for manl/ 

as.l 

mount . Im 

• • • 

spool/ 

delayed execution files 
at/ used by at(l) 
Ipd/ used by Ipr (l) 

lock present when line printer is active 
cf* copy of file to be printed, if necessary 
df* daemon control file, Ipd ( 8 ) 
tf* transient control file, while Ipr is 
working 
uucp/ 

work files and staging area for uucp (l) 
LOGFILE 

summary log 
LOG.* 

log file for one transaction 
mail/ 

mailboxes for mail (l) 

uid mail file for user uid 

uTd .lock 

lock file while uid is receiving mail 
wd initial working directory of a user, typically wd 
is the user's login name 
.profile 

set environment for sh(l), environ (5) 
calendar 

user's datebook for calendar (1) 
doc/ papers, mostly in volume 2 of this manual, 
typically in ms(7) format 
as/ assembler manual 
c C manual 

■ • • 

sys/ system source 

dev/ device drivers 
bio.c 

common code 
cat.c 

cat (4) 
dh.c DHll, tty(4) 
tty tty(4) 

• • • 

conf/ 
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hardware-dependent code 
mch.s 

assembly language portion 
conf configuration generator 

• • • 

h/ header (include) files 
acct.h 

acct (5) 
stat.H 

stat(2) 

• • • 

sys/ source for system proper 
main.c 
pipe.c 
sysent.c 

system entry points 

• • • 

/usr/ src/ 

source programs for utilities, etc. 
cmd/ source of commands 
as/ assembler 
makefile 

recipe for rebuilding the assembler 
asl?.s 

source of passl 
ar.c source for ar(l) 

troff/ 

source for nroff and troff (1) 
nmake 

makefile for nroff 
tmake 

makefile for troff 
font/ 

source for font tables, 

/usr/lib/font/ 

ftR.c 

Roman 

« • • 

term/ 

terminal characteristics tables, 

/usr/lib/term/ 

tab300.c 

DASI 300 



libc/ 

source for functions in /lib/libc.a 
crt/ C runtime support 
Idiv.s 

division into a long 
Imul.s 
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multiplication to produce long 

• • • 

csu/ startup and wrapup routines needed with 
every C program 
crtO.s 

regular startup 
mcrtO.s 

modified startup for cc -2 
sys/ system calls (2) 
access. s 
alarm. s 

• • • 

stdio/ 

standard I/O functions (3S) 

fgets.c 

fopen.c 

• • • 

gen/ other functions in (3) 
abs.c 
atof .c 

• • • 

compall 

shell procedure to compile libc 
mklib 

shell procedure to make /lib/libc.a 
libI77/ 

source for /lib/libI77 
libF77/ 

• • • 

games/ 

source for /usr/games 

SEE ALSO 

ls(l), ncheck(l), find(l), grep(l) 

RESTRICTIONS 

The position of files is subject to change without notice. 
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NAME 

man - macros to typeset manual 

SYNOPSIS 

nroff -man file ... 

troff -man file ... 

DESCRIPTION 

These macros are used to lay out pages of this manual. A 
skeleton page may be found in the file /usr/man/manO/xx. 

Any text argument t may be zero to six words. Quotes may be 
used to include blanks in a 'word'. If text is empty, the 
special treatment is applied to the next input line with 
text to be printed. In this way .1 may be used to italicize 
a whole line, or .SM followed by .B to make small bold 
letters. 

A prevailing indent distance is remembered between succes- 
sive indented paragraphs, and is reset to default value upon 
reaching a non- indented paragraph. Default units for 
indents i^ are ens. 

Type font and size are reset to default values before each 
paragraph, and after processing font and size setting mac- 
ros. 

These strings are predefined by -man: 
\*R troff. 



\*S Change to default type size. 



FILES 

/usr/1 ib/tmac/tmac . an 
/usr/man/manO/xx 

SEE ALSO 

troffd), man(l) 

RESTRICTIONS 

Relative indents don't nest. 



REQUESTS 
Request 

.B t 
.BI t 

.BR t 



Cause If no Explanation 

Break Argument 

no t=n.t.l.*Text t is bold. 

no t=n.t.l. Join words of t alternating bold and 

italic, 
no t=n.t.l. Join words of t alternating bold and 

Roman . 
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.5i li... Restore default tabs. 

i^=p.i.* Set prevailing indent to J^. Begin para- 
graph with hanging indent. 

t=n.t.l. Text t is italic. 

t=n.t.l. Join words of t alternating italic and 
bold. 

x="" Same as .TP with tag x. 

t=n.t.l. Join words of t alternating italic and 
Roman . 
Same as .PP. 

d=.4v Interparagraph distance is d. 

Begin paragraph. Set prevailing indent 
to .5i. 

End of relative indent. Set prevailing 
indent to amount of starting .RS. 

t=n.t.l. Join words of t alternating Roman and 
bold. 

t=n.t.l. Join words of t alternating Roman and 
italic. 

i=p.i. Start relative indent, move left margin 
in distance i_. Set prevailing indent to 
.5i for nested indents. 

t=n.t.l. Subhead. 
_ t=n.t.l. Text t is small. 

.TH n c x yes - Begin page named n of chapter c; x is 

extra commentary, e.g. 'local', for page 
foot. Set prevailing indent and tabs to 
.5i. 
.TP i_ yes i^=p.i. Set prevailing indent to i^. Begin 

indented paragraph with hanging tag 
given by next text line. If tag doesn't 
fit, place it on separate line. 

* n.t.l. = next text line; p.i. = prevailing indent 



.DT 


no 


.HP i 


yes 


.1 t 


no 


.IB t 


no 


.IP X i 

.IR t 


yes 

no 


.LP 
.PD d 


yes 
no 


.PP 


yes 


.RE 


yes 


.RB t 


no 


.RI t 


no 


.RS i 


yes 


.SH t 
.SM t 


yes 
no 
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NAME 



ms - macros for formatting manuscripts 



SYNOPSIS 

nroff -ms 
troff -ms 



[ 



options 
options 



] 



file 
file 



DESCRIPTION 

This package of nroff and troff macro definitions provides a 
canned formatting facility for technical papers in various 
formats. When producing 2-column output on a terminal, 
filter the output through col(l). 

The macro requests are defined below. Many nroff and troff 
requests are unsafe in conjunction with this package, how- 
ever these requests may be used with impunity after the 
first .PP: 

.bp begin new page 

.br break output line here 

.sp n insert n spacing lines 

.Is n (line spacing) n=l single, n*2 double space 

.na no alignment of right margin 

Output of the eqn , ne^n , refer , and tbl (l) preprocessors for 



equations and tables is acceptable as input. 



FILES 

/usr/1 ib/tmac/tmac . s 

SEE ALSO 

eqn(l), troff(l), refer(l), tbl(l) 



REQUESTS 
Request 

.IC 
.2C 
.AB 
.AE 
.AI 

.AT 

.AU X Y 

.B X 

.Bl 
.B2 

.BT 



Initial Cause 
Value Break 



yes 

no 

no 

no 

no 

no 

no 



yes 
yes 
yes 
yes 
yes 

yes 

yes 

no 



no yes 
no yes 
date no 



Explanation 

One column format on a new page. 
Two column format. 
Begin abstract. 
End abstract. 

Author's institution follows. Suppressed 
in TM. 

Print 'Attached' and turn off line fil- 
ling. 

Author's name follows, x is location and 
Y is extension, ignored except in TM. 
Print X in boldface; if no argument 
switch to boldface. 
Begin text to be enclosed in a box. 
End text to be boxed , print it. 
Bottom title, automatically invoked at 
foot of page. May be redefined. 



.BX X 


no 


no 


.CS X.. . 




yes 


.CT 


no 


yes 


.DA X 


nroff 


no 


.DE 


- 


yes 


.DS X 


no 


yes 
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Print X in a box. 

Cover sheet info if TM format, suppressed 
otherwise. Arguments are number of text 
pages, other pages, total pages, figures, 
tables, references. 

Print 'Copies to' and enter no-fill mode. 
'Date line' at bottom of page is x. 
Default is today. 
End displayed text. Implies .KE. 
Start of displayed text, to appear verba- 
tim line-by-line. x=I for indented 
display (default), x=L for left-justified 
on the page, x=C for centered, x=B for 
make left-justifTed block, then center 
whole block. Implies .KS. 
.EG no - Print document in BTL format for 

'Engineer's Notes.' Must be first. 
.EN - yes Space after equation produced by eqn or 

neqn . 
.EQ X Y " yss Precede equation; break out and add 

space. Equation number is y* "^^^ 
optional argument x may be l_ to indent 
equation (default!, L to left-adjust the 
equation, or C to center the equation. 
.FE - yes End footnote. 
.FS no no Start footnote. The note will be moved 

to the bottom of the page. 
.HO - no 'Bell Laboratories, Holmdel, New Jersey 

07733'. 
.1 X no no Italicize x; if x missing, italic text 

follows. 
.IH no no 'Bell Laboratories, Naperville, Illinois 

60540' 
. IM no no Print document in BTL format for an 

internal memorandum. Must be first. 
.IP X Y no yes Start indented paragraph, with hanging 

tag x« Indentation is y ens (default 5). 
.KE - yes End keep. Put kept text on next page if 

not enough room. 
.KF no yes Start floating keep. If the kept text 

must be moved to the next page, float 
later text back to this page. 
Start keeping following text. 
Make letters larger. 
Start left-blocked paragraph. 
Print docijment in BTL format for 
'Memorandum for File.' Must be first. 
.MH - no 'Bell Laboratories, Murray Hill, New Jer- 
sey 07974' . 
.MR - - Print document in BTL format for 

'Memorandum for Record.' Must be first. 
.ND date troff no Use date supplied (if any) only in 



.KS 
.LG 


no 

no 


yes 
no 


.LP 
.MF 


yes 


yes 



.NL 
.OK 


yes 


no 
yes 


.PP 

.PT 


no 
pg # 


yes 


.PY 


- 


no 


.QE 


- 


yes 


.QP 


- 


yes 


.QS 


- 


yes 


.R 
.RE 

.RP 


yes 
no 


no 
yes 
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special BTL format positions; omit from 
page footer. 

• NH n - yes Same as .SH, with section nxjunber supplied 

automatically. Numbers are multilevel, 
like 1.2.3, where n tells what level is 
wanted (default is 1). 
Make letters normal size. 
'Other keywords' for TM cover sheet fol- 
low. 

Begin paragraph. First line indented. 
Page title, automatically invoked at top 
of page. May be redefined. 
'Bell Laboratories, Piscataway, New Jer- 
sey 08854' 

End quoted (indented and shorter) 
material. 

Begin single paragraph which is indented 
and shorter. 

Begin quoted (indented and shorter) 
material. 

Roman text follows. 
End relative indent level. 
Cover sheet and first page for released 
paper. Must precede other requests. 

•RS - yes Start level of relative indentation. 

Following .IP's are measured from current 
indentation. 

.SG X no yes Insert signature(s) of author(s), ignored 

except in TM. x is the reference line 
(initials of author and typist). 

•SH - yes Section head follows, font automatically 

bold. 

Make letters smaller. 

Set tabs in ens. Default is 5 10 15 . . . 
End table. 

End heading section of table. 
Title follows. 

Print document in BTL technical memoran- 
dum format. Argioments are TM number, 
(quoted list of) case number(s), and file 
number. Must precede other requests. 
Print in BTL technical report format; 
report number is x. Must be first. 
Begin table; if x is H table has repeated 
heading. 

Underline arg\ament (even in troff). 
'UNIX'; first time used, add footnote 
'UNIX is a trademark of Bell Labora- 
tories. ' 

•WH - no 'Bell Laboratories, Whippany, New Jersey 

07981' . 



.SM 


no 


no 


• X, t\ A • • • 


3 • • • 


no 


.TE ~ 


- 


yes 


.TH 


— 


yes 


.TL 


no 


yes 


.TM X. . . 


no 




.TR X 


- 


- 


.TS X 


- 


yes 


.UL X 


— 


no 


.UX 


- 


no 
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NAME 



terminals- conventional names 



DESCRIPTION 

These names are used by certain commands and are maintained 
as part of the shell environment (see sh(l) ,environ(5) ) . 



1620 

1620-12 

300 

300-12 

300s 

300S-12 

33 

37 

40-2 

43 

450 

450-12 

450-12-8 

735 

745 

dumb 

hp 

4014 

tnl200 

tn300 

vt05 



DIABLO 1620 (and others using HyType II) 

same, in 12-pitch mode 

DASI/DTC/GSI 300 (and others using HyType I) 

same, in 12-pitch mode 

DASI/DTC 300/S 

same, in 12-pitch mode 

TELETYPE (Reg.) Model 33 

TELETYPE Model 

Model 

Model 

(same 



in 



37 

40/2 
43 

as Diablo 1620) 
12-pitch mode 

12-pitch, 8 lines/inch mode 
Instruments TI735 (and TI725) 
Instriiments TI745 
terminals with no special features 
Hewlett-Packard HP264? series terminals 
Tektronix 4014 

General Electric TermiNet 1200 
General Electric TermiNet 300 
Digital Equipment Corp. VT05 



TELETYPE 

TELETYPE 

DAS I 450 

same, in 

same, 

Texas 

Texas 



Commands whose behavior may depend on the terminal accept 
arguments of the form -Tterm, where term is one of the names 
given above. If no such argument is present, a command may 
consult the shell environment for the terminal type. 

SEE ALSO 

stty(l), tabs(l), plot(l), sh(l), environ(5) 
troff(l) for nroff 



RESTRICTIONS 

The programs that ought to adhere to this nomenclature do so 
only fitfully. 
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NAME 

boot - startup procedures 

DESCRIPTION 

Refer to ULTRIX-11 System Management Guide, Chapter 3 

FILES 

/unix - system code 

/mdec/hkuboot - copies of primary bootstraps 

/mdec/hpuboot 

/mdec/mluboot 

/mdec/rauboot 

/mdec/rdrxuboot 

/mdec/rkuboot 

/mdec/rluboot 

/mdec/rpuboot 

/boot - second stage bootstrap 

/boot.bu - backup copy of boot 

SEE ALSO 

ULTRIX-11 Installation Guide Section 1.3 
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NAME 

crash - what to do when the system crashes 

DESCRIPTION 

Refer to ULTRIX-11 System Management Guide, Chapter 9 

SEE ALSO 

ULTRIX-11 System Management Guide, Chapter 8 ULTRIX-11 Sys- 
tem Management Guide, Chapter 10 
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NAME 

cron - clock daemon 

SYNOPSIS 

/etc/cron 

DESCRIPTION 

Cron executes commands at specified dates and times accord- 
Tng~to the instructions in the file /usr/lib/crontab. Since 
cron never exits, it should only be executed once. This is 
best done by running cron from the initialization process 
through the file /etc/rc; see init (8) . 

Crontab consists of lines of six fields each. The fields 
are separated by spaces or tabs. The first five are integer 
patterns to specify the minute (0-59), hour (0-23), day of 
the month (1-31), month of the year (1-12), and day of the 
week (1-7 with l=monday) . Each of these patterns may con- 
tain a number in the range above; two numbers separated by a 
minus meaning a range inclusive; a list of numbers separated 
by commas meaning any of the numbers; or an asterisk meaning 
all legal values. The sixth field is a string that is exe- 
cuted by the Shell at the specified times. A percent char- 
acter in this field is translated to a new-line character. 
Only the first line (up to a % or end of line) of the com- 
mand field is executed by the Shell. The other lines are 
made available to the command as standard input. 

Crontab is examined by cron every minute. 

FILES 

/usr/1 ib/crontab 
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NAME 

dmesg - collect system diagnostic messages to form error log 

SYNOPSIS 

/etc/dmesg C - ] [ corefile [ namelist ] ] 

DESCRIPTION 

Dyesq looks in a system buffer for recently printed diagnos- 
tic messages and prints them on the standard output. The 
messages are those printed by the system when device 
(hardware) errors occur and (occasionally) when system 
tables overflow non-fatally. If the - flag is given, then 
dmesg computes (incrementally) the new messages since the 
last time it was run and places these on the standard out- 
put. This is typically used with cron (8) to produce the 
error log / usr / adm / messaqes by running the command 

/etc/dmesg - » /usr/adm/messages 

every 10 minutes. 

The ULTRIX-11 error logging system logs hardware related 
errors, dmesg is used to save other types of error messages. 

The optional corefile and namelist options can be used for 
postmortem debugging. If corefile is specified, it will be 
used instead of /dev/mem; if namelist is also specified, it 
will be used instead of / unix . 

FILES 

/usr/adm/messages error log (conventional location) 

/usr/adm/msgbuf scratch file for memory of - option 

/dev/mem default corefile 

/unix default namelist 

SEE ALSO 

ULTRIX-11 System Management Guide, Chapter 8 ULTRIX-11 Sys- 
tem Management Guide, Chapter 9 

RESTRICTIONS 

Referring to dmesg as the error log is a misnomer. 

The system error message buffer is of small finite size. As 
dmesg is run only every few minutes, not all error messages 
are guaranteed to be logged. If this happens, dmesg will 
print '...' before printing the buffer. This can be con- 
strued as a blessing rather than a curse. 

Error diagnostics generated immediately before a system 
crash will never get logged. 
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NAME 

getty - set typewriter mode 

SYNOPSIS 

/etc/getty [ char ] 

DESCRIPTION 

Getty is invoked by init(8) immediately after a typewriter 
Ti opened following a dial-up. It reads the user's login 
name and calls login (l) with the name as argument. While 
reading the name getty attempts to adapt the system to the 
speed and type of terminal being used. 

Init calls getty with a single character argxament taken from 
the ttys (5) file entry for the terminal line. This argument 
is used as an index into the qettytab (5) database, to deter- 
mine the characteristics of the line. If there is no 
/ etc / gettytab a set of system defaults is used. 

The user's name is read a character at a time. If a null 
character is received, it is assumed to be the result of the 
user pushing the 'break' ('interrupt') key. The speed is 
usually then changed and the greeting message is printed 
again. Successive 'break' characters cycle through some 
standard set of speeds. 

The user's name is terminated by a new-line or carriage- 
return character. In the second case CRMOD mode is set (see 
ioctl(2)). 

The name is scanned to see if it contains any lower-case 
alphabetic characters; if not, and if the name is nonempty, 
the system is told to map any future upper-case characters 
into the corresponding lower-case characters. 

Finally, login is called with the user's name as argument. 

Most of the default actions of getty can be circvunvented, or 
modified, by a suitable gettytab table. 

The following arguments from the ttys file are understood. 

Cycles through 300-1200-150-110 baud. Useful as a 
default for dialup lines accessed by a variety of ter- 
minals. 

Intended for an on-line Teletype model 33, for example 
an operator's console. 

1 Optimized for a 150-baud Teletype model 37. 

2 Intended for an on-line 9600-baud terminal, for example 
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a Digital VTIOO series terminal. 

3 Starts at 1200 baud, cycles to 300 and back. Useful 
with 212 datasets where most terminals run at 1200 
speed. 

5 Same as '3' but starts at 300. 

4 Useful for on-line console DECwriter (LA36). 

6 Intended for an on-line 2400-baud terminal. 

7 Intended for an on-line 4800-baud terminal, 
a Fixed speed 110-baud terminal. 

b Fixed speed 135.4-baud terminal. 

d Fixed speed 600-baud terminal. 

f Fixed speed 1200-baud terminal. 

For additional terminal types and special purpose entries, 
refer to a listing of the / etc / gettytab table. 

FILES 

/etc/gettytab 

SEE ALSO 

.gettytab(5), init(8), login(l), ioctl(2), ttys(5) 
ULTRIX-11 System Management Guide, Section 4.6 



INIT(8) INIT(8) 



NAME 

init, re - process control initialization 

SYNOPSIS 

/etc/init 
/etc/rc 

DESCRIPTION 

Init is invoked as the last step of the boot procedure. 
Generally its role is to create a process for each type- 
writer on which a user may log in. 

When init first is executed the console typewriter 
/ dev / console . is opened for reading and writing and the 
shell is invoked immediately. This feature is used to bring 
up a single-user system. If the shell terminates, init 
comes up mult i -user and the process described below is 
started. 

When init comes up multiuser, it invokes a shell, with input 
taken from the file / etc /rc. This command file performs 
housekeeping like removing temporary files, mounting file 
systems, and starting daemons. 

Then init reads the file / etc / ttys and forks several times 
to create a process for each typewriter specified in the 
file. Each of these processes opens the appropriate type- 
writer for reading and writing. These channels thus receive 
file descriptors 0, 1 and 2, the standard input, output and 
error files. Opening the typewriter will usually involve a 
delay, since the open is not completed until someone is 
dialed up and carrier established on the channel. Local 
typewriters are opened immediately, see ttys(5). Then 
/ etc / getty is called with argument as specified by the 
second character of the ttys file line, Getty reads the 
user's name and invokes login (l) to log in the user and exe- 
cute the shell. 

Ultimately the shell will terminate because of an end-of- 
file either typed explicitly or generated as a result of 
hanging up. The main path of init , which has been waiting 
for such an event, wakes up and removes the appropriate 
entry from the file utmp , which records current users, and 
makes an entry in / usr / adm / wtmp , which maintains a history 
of logins and logouts. Then the appropriate typewriter is 
reopened and getty is reinvoked. 

Init catches the hangup signal SIGHUP, which causes init to 
reread the /etc/ttys file. To bring new terminals on-line 
or take existing terminals off-line, edit the /etc/ttys file 
and use 'kill -11' to send the hangup signal to init . Only 
those terminals whose flag character, in the /etc/ttys file, 
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has been changed will be affected. 

FILES 

/dev/tty?, /etc/utmp, /usr/adm/wtmp, /etc/ttys, /etc/rc 

SEE ALSO 

login(l), kilKl), sh{l), ttys{5), getty(8) 

ULTRIX-11 System Management Guide, Sections 1.2.2, and 3.1 
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NAME 



Ipd - line printer daemon 



SYNOPSIS 

/usr/lib/lpd 

DESCRIPTION 

Lpd is the daemon for the line printer. Lpd uses the direc- 
tory / usr / spool / lpd . The file lock in that directory is 
used to prevent two daemons from becoming active. After the 
program has successfully set the lock, it forks and the main 
path exits, thus spawning the daemon. The directory is 
scanned for files beginning with df. Each such file is sub- 
mitted as a job. Each line of a job file must begin with a 
key character to specify what to do with the remainder of 
the line. 

L specifies that the remainder of the line is to be sent 
as a literal. 

B specifies that the rest of the line is a file name. 

F is the same as B except a form feed is prepended to the 
file. 

U specifies that the rest of the line is a file name. 
After the job has been transmitted, the file is 
unlinked. 



M is followed by a user ID; after the job is sent, a mes- 
sage is mailed to the user via the mail (l) command to 
verify the sending of the job. 

Any error encountered will cause the daemon to wait and 
start over. This means that an improperly constructed df 
file may cause the same job to be submitted repeatedly. 

Lpd is automatically initiated by the line printer command, 
Ipr . 

To restart lpd (in the case of hardware or software malfunc- 
tion), it IS necessary to first kill the old daemon (if 
still alive), and remove the lock file before initiating the 
new daemon. This is done automatically when the system is 
brought up, by / etc /rc, in case there were any jobs left in 
the spooling directory when the system last went down. A 
new line printer daemon is initiated with the command 
Vetc/lpdrestart ' . 
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FILES 

/usr/spool/lpd/* spool area for line printer daemon 

/etc/passwd to get the user's name 

/dev/lp line printer device 

/etc/lpdrestart to restart the line printer daemon 

SEE ALSO 

Ipr(l) 
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NAME 

makekey - generate encryption key 

SYNOPSIS 

/usr/1 ib/makekey 

DESCRIPTION 

Makekey improves the usefulness of encryption schemes 
depending on a key by increasing the amount of time required 
to search the key space. It reads 10 bytes from its stan- 
dard input, and writes 13 bytes on its standard output. The 
output depends on the input in a way intended to be diffi- 
cult to compute (i.e. to require a substantial fraction of a 
second) . 

The first eight input bytes (the input key ) can be arbitrary 
ASCII characters. The last two (the salt) are best chosen 
from the set of digits, upper- and lower-case letters, and 
'.' and '/'. The salt characters are repeated as the first 
two characters of the output. The remaining 11 output char- 
acters are chosen from the same set as the salt and consti- 
tute the output key . 

The transformation performed is essentially the following: 
the salt is used to select one of 4096 cryptographic 
machines all based on the National Bureau of Standards DES 
algorithm, but modified in 4096 different ways. Using the 
input key as key, a constant string is fed into the machine 
and recirculated a number of times. The 64 bits that come 
out are distributed into the 66 useful key bits in the 
result. 



Makekey is intended for programs that perform encryption 

TeTc 

be I 

SEE ALSO 



Makekey is intended for programs that perform encryption 
(e.g. ed and crypt (1) ) . Usually its input and output will 
be Dioes. 



be pipes. 

^LSO 
crypt(l), ed(l) 
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NAME 



shutdown - orderly system shutdown 



DESCRIPTION 

The shutdown command is obsolete, the operator services pro- 
gram IS used for system shutdown. Read the ULTRIX-11 System 
Management Guide, Chapter 5 for a description of the opera- 
tor services program. 
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NAME 

ulf - universal lineprinter filter 

SYNOPSIS 

invokenarae username 

DESCRIPTION 

Output is sent through ulf before it is allowed to hit the 
lineprinter. 

Ulf filters out control characters, and buffers up lines for 
devices like diablos. Accounting records are written in 
/usr/adm/lpacct by ulf at the time of completion of each 
job. 

Ulf checks to see what name it has been called by so that it 
will know what entry to look up in /etc/printcap. The 
account name of the user that was responsible for this invo- 
cation of ulf is passed as its one and only argxament. This 
argument is needed to determine who to bill the pages to. 
Ulf supports diablos and dumb (LA180, LA120) "lineprinters" . 

Ulf uses a "line_structure" that is a linked list of arrays 
to hold enough characters for one physical line on the line- 
printer. The first array contains the characters of the 
line, and all subsequent arrays hold overprinting charac- 
ters. Blanks are left as zero's, so that they don't have to 
be printed, just move the printhead whatever way is easiest. 

AUTHOR 

Cliff Matthews, University of New Mexico 

FILES 

/etc/printcap 

DIAGNOSTICS 

Are sent to wherever /etc/printcap specifies with the If 
field. I like to see them go to /dev/null, because they 
tend to be generated in large quantities, and can fill up a 
filesystem very quickly. If the software doesn't work, the 
errors should be dumped to disk and examined. After the 
source of the trouble has been fixed, it is advisable to 
have the errors routed back to /dev/null. 

SEE ALSO 

Ipr(l), printcap(5), lpd(8) 
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NAME 



update - periodically update the super block 



SYNOPSIS 

/etc/update 

DESCRIPTION 

Update is a program that executes the sync (2) primitive 
every 30 seconds. This insures that the file system is 
fairly up to date in case of a crash. This command should 
not be executed directly, but should be executed out of the 
initialization shell command file. 

SEE ALSO 

sync(2), sync(l), init(8) 



RESTRICTIONS 

With update running, if the CPU is halted just as the sync 
is executed, a file system can be damaged. This is par- 
tially due to DEC hardware that writes zeros when NPR 
requests fail. A fix would be to have sync (l) temporarily 
increment the system time by at least 30 seconds to trigger 
the execution of update . This would give 30 seconds grace to 
halt the CPU. 



